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PREF ACE 


This manual describes a facility used to access Multics Relational Data Store 
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This manual presupposes some basic knowledge of the Multics system, and does not 
attempt to provide information covered in either of the following two manuals: the 
New Users' Introduction to Multics - Part I and Part II, Order No. CH24 and CH25 
respectively. 


Throughout this manual, references are frequently made to other Multics manuals. 
For convenience, these references are as follows: 


DOC UMENT REFERRED TO IN TEXT AS 
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Reference Manual, Order No. AW53 
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Significant Changes in this Addendum 


Section 5 -- added Linus request names in the page header, added a new linus 
request (opened database), substituted long names for all abbrevs in request 
examples, and added active request capabilities to the following linus requests: 


assign values 
del _ scope 
list_scope 
list_values 
open 
set_scope 


The information and specifications in this document are subject to change without notice. Con- 
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New Section 7 -- relocated Exec Com Facility description from Section 5. 


Appendix A -- added parameters defining generation of linus_lila_tokens. 
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SECTION 1 


SELECTION LANGUAGE 


The Logical INquiry and Update System (LINUS) is a powerful, yet "easy-to-use" 
facility for accessing centralized Multics Relational Data Store (MRDS) data 
bases. However, it is also possible for users to define private data bases and 
utilize LINUS to access and maintain them (refer to Section 3). LINUS provides 
a complete data base management capability including both retrieval and update 
operations. Data to be selected is specified via a selection language which is 
a high-level nonprocedural language capable of being understood and used by 
individuals who are not necesSarily computer specialists. 


Several of the LINUS requests (e.g., modify, delete, and print) operate on 
well-defined subsets of a data base. These data base subsets are selected via 
query statements. The user views the data base as a set of tables containing 
rows and columns of data. LINUS allows the selection algorithm to be specified 
as a series of table lookup operations, very similar to the way an individual 
manually scans a set of tables for information. For example, envision a telephone 
directory as being a table with three columns of information: name, address, 
and phone number. This table contains one row of information for each individual 
listed in the directory. Normally, to find the phone number for John C. Smith, 
the name column is seanned for the name "Smith John C", and the value is taken 
from the phone number column in the same row. In LINUS, this operation is 
described as: 


select number 


from phone book 
where name = "Smith John C" 
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Various features of LINUS are introduced via examples referencing a data 
base consisting of the following five tables that describe the operation of a 
department store: 


emp 


supply 


The emp table contains a row of information on every employee, giving employee 
name, employee number, department, manager's employee number, salary, and commission 
for the last year. The sales table gives the volume of sales for every item 
within each department. The supply table provides the volume of each item supplied 
by every supplier. The loc table gives the floor on which every department is 
located, and the class table specifies the type of each item. 


In each of the tables, the underscored words denote key columns. Every row 
in a table is uniquely identified by its values in the key columns. The LINUS 
user need not be concerned with the Key column concept except when using the 
modify and define temp_table requests discussed later. 


The basic component of the selection language is the select-from-where block, 
which is used to select column values from one or more tables where rows of the 
tables satisfy certain conditions. It should be noted that the indention of the 
following examples is for readability only, and is not required in actual usage. 
In fact, the entire query may be contained in one line. 


The select clause and the from clause must always be specified in a 
select-from-where block. The where clause of a block may be omitted, in which 
case all rows are returned. 


Example 1 


List all departments from the emp table. 


select dept 
from emp 


This could alternately be written as: 


select dept from emp 
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A select clause may contain one or more column names, or may contain an 
asterisk (*) which indicates that all columns from qualifying rows are to be 
Selected. 


Example 2 


List all information pertaining to every employee whose Salary is greater 
than $8,000. 


select #* 
from emp 
where sal > 8000 


More complex conditions may be specified in the where clause, as shown in 
the remaining examples in this section. Specifically, a where clause may contain 
one or more terms. Each term consists of a column name or an arithmetic expression; 
followed by a relational operator; followed by a column name, arithmetic expression, 
or constant. Allowable relational operators are: 


greater than 

less than 

less than or equal to (or not greater than) 
greater than or equal to (or not less than) 
equal to 

not equal to 


IHU VANNM 


Terms within the where clause must be separated by logical operators, and may be 
grouped using parentheses () to explicitly specify order of evaluation. Allowable 
logical operators are: 


& logical conjunction (and) 
| logical inclusive (or) 
S logical negation (not) 
Character string constants within terms must be enclosed within quotes "", If a 


quote is to appear within a character string, a double quote must be specified. 
Example 3 


Find the names and salaries of employees in the toy department who work for 
Anderson, whose employee number is 1423. 


select name sal 
from emp 
where dept = "Toy" & mgr = 1423 


Example y 


Arithmetic expression may be contained in both the select clause and the 
where clause. All columns used in any given arithmetic expression must be defined 
over the same domain. Allowable operators in an arithmetic expression are: 


addition 
subtraction 
multiplication 
division 


“oR ET + 
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Find the names of employees who are either in the Admin department or whose 
sum of salary and commission exceeds $10,000. 


select name 
from emp 
where dept = "Admin" |! sal + comm > 10000 


It is possible to specify more complex table lookup operations by using a 
select-from-where block as the last component of a term in the where clause. 
This indicates that the comparison specified in the term is to be performed for 
every value selected by the inner block. All inner select-from-where blocks 
must be delimited by braces {}. 


Example 5 


Find all items sold by departments located on the second floor. 


select item 
from sales 
where dept = {select dept 
from loc 
where floor = 2} 


One can apply set functions to the results of a select-from-where block, as 
shown by the following examples. Allowable set functions are: min, max, count, 
avg, sum, and user-defined functions. User-defined functions are discussed in 
Section 2 (Writing Nonstandard Functions) and in Section 4 (Declare Request). 


Example 6 


Find the average salary of employees in the shoe department. 


avg {select sal 
from emp 
where dept = "Shoe"} 


Example 7 


Find all employees whose salary is greater tnan that of any employee in the 
shoe department. 


select name 
from emp 
where sal > max {select sal 
from emp 
where dept = "Shoe"} 


A select clause can also contain an arithmetic expression as shown in the 
following example. 


1-4 AZ49-03 


Example 8 


Find each employee in the shoe department, together with her/his deviation 
from tne average salary of that department. 


select name sal - avg {select sal 

from emp 

where dept = "Shoe"} 
from emp 
Where dept = "Shoe" 


Set operations can be applied to the results of select-from-where blocks. 
In LILA the set operations are union, differ, and inter, which correspond to the 
union, difference, and intersection operations as normally defined. That is, 
the union of two sets consists of all items that belong to one or both of the 
sets. The intersection of two sets consists of those items belonging to both 
sets. The difference of two sets consists of those items which belong to the 
first set, but not to the second. For example, assume that set A contains the 
elements "a", "b", and "c" and the set B contains the elements "ce", "d", and 
"elt, then: 


A union B (and B union A) is abede (all items belong to one or both 


sets) 
Set A Set B 
A inter B (and B inter A) is ec (items belong to both sets) 
Set A Set B 
A differ B is ab (items belong to the first, but not second set) 


Set A Set B 


1=5 AZ49-0 3 


B differ Ais de (items belong to the first, but not second set) 


Set A Set B 


Example 9 


Find those items which are supplied by Levi and sold in the men's department. 


select item 

from supply 

where supplier = "Levi" 
inter 

Select item 

from sales 

where dept = "Men" 


Nesting of select-from-where blocks is possible in order to specify complex 
selection criteria. 


Example 10 


Find the total volume of type A items sold by departments on the second floor. 


sum {select vol 
from sales 
where item = {select item 
from class 
where type = "A"} & 
dept = {select dept 
from loc 
where floor = 2}} 


It is also acceptable to bypass the nested block notation and use table names to 
qualify column names (including *) within the select and where clauses. This 
qualification is accomplished by prefixing a column name with a table name followed by 
a dot (.). Whenever two or more table names are specified in the from clause of a 
block, all column names used within that block must be qualified. Using this 
approach, the above expression becomes: 


sum {select sales.vol 
from sales class loc 
where sales.item = class.item & class.type = "A" 
& sales.dept = loc.dept & loc.floor = 2} . 


Finally, variables that assume rows of a designated table can be specified as 
values. In certain complex queries requiring comparisons among different rows of the 
same table, such row designators are veauired toresolve ambiguity. In essence, this 


hla np ha tenntad 1 bn : 
a@L1OWS a4 Single table to be treated as multiple tables in the select and where clauses. 


A row designator is associated with a table by adding a prefix consisting of the row 
designator name followed by a colon (:) to the table name in the fromclause. Several 
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row designators may be associated with a single table. The row designator is used in j 
the select clause and where clause like a table name to qualify a column name. 


Example 11 


For all employees who earn more than their managers, select the employee's name 
and that of his manager. 


select employee.name manager .name 
from employee:emp manager :emp 
where employee.mgr = manager.emp no & employee.sal > manager.sal 


These examples are intended as an introduction to basic features of the selection 
language. The information should aliow the reader to write queries to satisfy a large 
class of data selection requirements. However, users should become familiar with the 
information in the remainder of this section for precise descriptions of the complete 
capabilities of the selection language. 


SYNTAX AND SEMANTICS OF THE SELECTION LANGUAGE 


ee mE aN eee 


A formal syntax is presented below using a metalanguage derived from Backus-Naur Form. 
The metalanguage symbols are defined as: 


< > denotes a syntactical construct 

:3= means "is defined as" 

{[ ] denotes zero or one occurrence of (optional) 

.-. denotes one or more occurrence of 

i denotes the logical inclusive "OR" 

The inclusion of an underscore character under any of the symbols distinguishes that 
symbol as not being a part of the metalanguage, but as being a part of the selection 


language syntax (see <bool_op> below). 


<select_expr> ::= 
<set_value> | <select _set> 


<set_value> ::s 
<set_fn> {<select_set>} 


<set_fn> ::= 
<set_builtin> {| <user_set_fn> 


<select set> ::= 
<select_block> {i <select _set> <set_op> <select_block> ; 
i<select_set>} 


<set_op> :: 
union ; inter ; differ 


<select block> ::= 
select <select _list> from <from_list> 


i Sélect <select list> from <from_list> where <conditional> 


<select list? ::= 


| <select _item_list> 
i dup <select_item_list> {| unique <select_item_list> 
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<select_item_list> ::= 
<select_item> |; <select _item_list> <select_item> 
<select item> ::= 
<table name>.* | <row_desig>.* | <expr> 


<expr> i: 

<column_spec> | <secalar_fn> (<arg_list>) 
| <expr> <arith_op> <arithmetic_ constant> 
| <expr> <arith _ __op> <linus variable> 
' <expr> <arith | _op> <set_ value> 
| <expr> <arith_op> <expr> { (<expr>) 


<column Spec? ae 
column name> | <table name>.<column name> 
i <row | desig>. <column_ name> 


<sealar_fn> ::= 
<scalar_builtin> ; <user_scalar_fn> 


<arg list> ::= 
<arg> | <arg_list>, <arg> 

<arg> iis 
<expr> | <constant> | <set_value> 


<arith_op> ::= 
an eee ie ee 

<from_list> ::= 
<table _item> | <table _item> <from_list> 


<table item :: 
<table name> {| <row_tab_pair> 


<row_tab_pair> ::= 

<row_desig>: <table name> 
<eonditional> ::= 
<term> {| <conditional> <bool_op> <term> 
i *(Xeonditional>) | (<eonditional>) 
<expr> <rel_op> <atom> 
<rel_op> 
<bool op> : 
<atom> ::= 

<expr> i; <constant> | <set_value> | {<select _block>} 
<constant> ::= 


<arithmetic constant> |; <bit_string_constant> | 
<character_string_constant> 7 <linus_variable> 


.€linus_ variable> ::= 


!<identifier> 


<table name> ::= 
<identifier> 


<row_desi 
73 
Na 


2. 0Q 
Vv 
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<letter>:: 


<digit>: 


<column name> sist, 


<identifier> 


<user_set_ fn> ::= 


<fn_name> 


<user_scalar_fn> ::= 


<fn_name> 


<identifier>::= 


<letter>[<letter> i<digit>! i$}... 
Al 
al 


01112131415 16171819 


NOTES: A <set_builtin> is one of the built-in set functions described in Section 


2. A<scalar_builtin> is one of the built-in scalar functions described 
in the same section. A <user_set_fn> and a <user_scalar_fn> must be 
declared according to the specifications contained in the declare 
request description (refer to Section 4). 


If <select _set>s are within a <select _set>, they may optionally be 
grouped by braces {} to explicitly specify the order of evaluation. If 
not explicitly specified, intersections and differences are evaluated 
prior to unions, and evaluation proceeds from left toright for operators 
of equivalent precedence. 


The <set_op>s union, inter, and differ correspond to the set operations 
union, intersection, and difference respectively. 


The <select_list>s of all <select_block>s within a <select_set> must be 
union-compatible; that is, corresponding columns must take their values 
from the same domain. Also, such<select_list>s may not contain <expr>s 
other than <column_spec>s. 


If the where clause is omitted from a<select_block>, all rows within the 
<from_list> qualify. 


A <select _list> of * indicates that all column values from the row are to 
be selected. If the <select_list> is a *, then the <from_list> must bea 
<table name>. 


A specification of dup within a <select_list> indicates that duplicate 
sets of selected values are not to be eliminated, whereas a specification 
of unique indicates that duplicates are to be eliminated. If neither is 
specified, the default rule applies. The default is dup if a <set_fn> is 
to be applied to the selected values and is unique otherwise. 


It should be noted that the use of scalar functions in the select clause 
may result in duplicate rows even though unique is specified. Thatis, 
LINUS applies scalar functions to column values returned from MRDS 
because of the select clause. MRDS actually does the duplicate 
elimination processing, but it does not know about built-in functions in 
the select clause. 
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A <select_item> of <table _name>.* or <row_desig>.* indicates that all 
columns from the row are to be selected. A <table name> is the nameofa 
previously defined temporary table, or a table defined within the data 
base. A <row_desig> is a row designator that is associated with a 
<table name> in a <from_list>. 


All <column_spec>s within an <expr> or <arg list> must refer to column 
values from the same row. 


Items within an <expr> may optionally be grouped by parentheses () to 


explicitly determine the order of evaluation. If not explicitly 
specified, all multiplications (*) and.divisions (/) are performed 
before any additions (+) or subtractions (-). Multiplications and 


divisions are performed from left to right, as are additions and 
subtractions. 


A <row_tab_pair> is used to specify the association of a row designator 
with a table. A <row_desig> must be unique for the entire 
<select _block>. 


Items within a <conditional> may optionally be grouped by parentheses to 
explicitly specify the order of evaluation. If the order is not 
explicitly specified, the and (&) operators are evaluated prior to theor 
(|) operators; the and evaluation proceeds from left to right for 


operators of equivalent precedence. 


The items <arithmetic constant>, <bit_string_constant>, and 
<character_string_ eonstant> are as defined ‘in the PL/I Manual. An 
<identifier> is as defined in Multics PL/I with the exceptions that the 
dollar sign ($) is not allowed and the hyphen (-) is allowed, so long as it 
is not the first or last character of the <identifier>. An <fn name> is 
the same as the <identifier> except that the hyphen is not allowed. 
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SECTION 2 


BUILT-IN AND INSTALLATION-DEFINED FUNCTIONS 


BUILT-IN FUNCTIONS 


The available built-in functions in LINUS are listed alphabetically and are 
immediately followed by a detailed description. Several of the built-in functions 
are used in the numbered examples included in Section 1. 


abs count reverse 
after floor round 
avg index search 
before max substr 
eeil min sum 
coneat mod verify 


Function: abs 


This is an arithmetic scalar function whose reference has the form: 
abs (X) 


The result of this function is the absolute value of X, where X must be a 
numeric data item. xX can only be real and the result value is a float decimal 
(59). 


Function: after 


This is a string scalar function whose reference has the form: 
after (S1, S2) 


The result is that portion of S1 that occurs to the right of the leftmost 
oecurrence of S2 within S1. If S2 is a null string, the result is $1. If S82 
does not occur within S1, the result is a null string. For example: 


after ("abcede", "be™) = "de" 
after ("abede", "") = "abede" 
after ("abede", nr) = wee 

after ("10101"b, "10"b) = "101"b 
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Function: avg 
This is an arithmetic set function whose reference 
has the form: 


avg {select X 
from .«s} 


The result is the average (mean) of all X values selected. For example: 
avg {select sal 
from emp 
where dept = "Shoe"} 


is the average salary of all employees in the shoe department. 


Function: before 


This is a string scalar function whose reference has the form: 
before (S1, S82) 


The result is that portion of Si that occurs to the left of the leftmost occurrence 
of S2 within Si. If S2 is a null string, the result is a null string. If Se2 
does not lie within S1, then the result is S81. For example: 


before ("abcde", "be™) = "at 
before ("abede", wet) - =m 
before ("abcde", "f") = "abcde" 


before ("10101"b, "10"b) = ""b 


Function: ceil 


This is an arithmetic scalar function whose reference has the form: 
ceil (X) 
where X must be real. The result is the smallest integer (I) such that: 
I >= X 
For example: 
ceil (20.5) = 21 


ceil (-14.6) = -14 
eeil (12) = 2 
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Function: concat 


This is a string scalar function whose reference has the form: 
coneat (S11, S82) 
The result is the concatenation of S1 and S2. For example: 


coneat ("abe", "de") = "abcde" 
econcat ("101"b, "01"b) = "10101"b 


Function: count 


This is an arithmetic set function whose reference has the form: 


count {select X1 X2... 
from ...} 


The result is the number of sets of Xi which are selected. For example: 
count {select name 
from emp 
where dept = "Shoe"™} 


is the number of employees in the shoe department. 


Function: floor 


This is an arithmetic scalar function whose reference has the form: 
floor (X) 
where X is real. The result is the largest integer (I) such that: 
I <= X 
For example: 
floor (20.5) = 20 


floor (-14.6) = -15 
floor (12) = 12 


eS 
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Function: index 


This is a character string scalar function whose reference has the form: 
index (S1, $2) 
The result is an integer that is the position of the beginning of the leftmost 
occurrence of S2 within S81. If S2 is not in S1 then the result is Cc. If S2is 
a null string, the result is 0. For example: 
index ("abede", "be") = 2 


index ("abede", "f") = 0 
index ("abcde", "") = Q 


Function: max 


This is an arithmetic set function whose reference has the form: 


max {select X 
from ...} 


The result is the largest X value selected. For example: 
max {select sal 
from emp 
where dept = "Shoe"} 


is the highest salary paid to any employee in the shoe department. 


Function: min 


This is an arithmetic set function whose reference has the form: 


min {select X 
from ...} 


The result is the smallest X value selected. For example: 
min {select sal 
from emp 
where dept = "Shoe"} 


is the lowest salary paid to any employee in the shoe department. 
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Funetion: mod 


This is an arithmetic scalar function whose reference has the form: 
mod (xX, Y) 
where X and Y are real. The result is X modulus Y, such that: 


if ¥-7=- 0. then mod: xy oY) =X eo YF 6or: Ck. Ff XD 
if Y = 0 then mod (X, Y) = X 


For example: 
mod (42, 5) = 2 


mod (129.2867, 25) = 4.2867 
mod (10, 0) = 10 


Function: reverse 


This is a string scalar function whose reference has the form: 
reverse (S) 
The result is a string which is the reverse of the value of S. For example: 
reverse ("abcde") = "edcba" 
reverse ("a™) = "a" 


reverse ("") = um 
reverse ("10110"b) = "01101"b 


This is an arithmetic scalar function whose reference has the form: 
round (X, Q) 


The result is a rounding of the value of X. When a value is rounded to n 
digits, the digits after the nth digit are dropped, and the nth digit is increased 
by 11if the (n+1)th digit is 5 or greater for decimal, or 1 for binary. If X is 
float, then Q must be positive and the mantissa is rounded to Q digits. If X is 
fixed, it is rounded to a value that has Q fractional digits. For complex 
values, the function is defined by: 


round (X + Yi Q) = round (X, Q) + round (Y, Q)i 
For negative values the following algorithm is used: 
round (x) = round (abs(X)) * -1 
For example: 
round (183.629e6, 4) = 183. 6e6 
round (183.629, 2) = 183.63 


round (183.629, -1) = 180 
round (21.56 + 6.211, 0) = 22 + 6i 
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Function: search 


This is a character string scalar function whose reference has the form: 
search (Ci, C2) 
The result is an integer value that is the position in C1 of the leftmost 
occurrence of any character contained in C2. If C1 does not contain any character 
in C2, the result is 0. For example: 
search ("abcde", "b") = 2 
search ("abcde", "") = 0 


b 

? 
search ("abcde", "f") = 0 
search ("abcede", "be") = 2 


Function: substr 


This is a string scalar function whose reference has the form: 
substr (S, I, Jd) 
-ore 
substr (S, I) 
The result is that portion of S that begins with the Ith character and has 
length J (if J is present), or is that portion of S that begins with the Ith 
character and continues to the end of S (if J is not present). For example: 
substr ("abcde", 3, 2) = "ed" 
substr ("abcede", 3, 0) =" 
$ 


substr ("abede", 3) = "ede" 
substr ("10101"b, 3) = "101"b 


Function: sum 


This is an arithmetic set function whose reference has the form: 


sum {select X 
from ...} 


The result is the total of all selected values. For example: 
sum {select vol 
from sales 
where dept = "Shoe"} 


provides the total sales volume of the shoe department. 
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Function: verify 


This is a character string sealar function whose reference has the form: 
verify (C1, C2) 
The result is an integer value that is the position of the first character of C1 that 


does not occur inC2. When C1 contains only characters that are in C2, the result is 0. 
For example: 


verify ("xyz", "abe"™) = 1 
verify ("xyz", "xyz") = 0 
verify ("abede", "cba") = 4 


WRITING NONSTANDARD FUNCTIONS 


Nonstandard (or installation-defined) functions may be written in any language 
that accepts and processes a standard Multics argument list. It is assumed that these 
funetions are written by experienced programmers. (Refer to the linus command 
"declare" request in Section 5 for an example of declaring a nonstandard function.) 


Sealar functions are passed a complete standard Multics argument list containing 
argument pointers and descriptor pointers for both the input arguments.and the return 
argument. The call is equivalent to: 


return val = fn_name$fn_name (in_argl, ..., in_argn); 


Set functions are called differently in that they are called several times and 
require three procedure entry points. 


The first entry point is the init entry, which is calied one time for evaluation 
of each set function. The method of evaluating a set function requires that data be 
accumulated in static storage. The purpose of this entry point is to initialize that 
Static storage. The init entry is equivalent to: 


call fn_name$Sfn_name_init; 

The second entry point is the cale entry, whichis called one time for each set of 
selected values. Tnis entry is passed a complete standard Multics argument list 
containing argument pointers and descriptor pointers for all of the declared input 
arguments. The purpose of the cale entry point is to calculate (or accumulate) the 
value for the set function. The call to the cale entry is equivalent to: 

call fn_name$fn_name_cale (in_argi, ..., in_argn); 

The third entry point ofa set function is the assignentry. This entry is called 
after the cale entry has been called for all sets of selected values. The purpose of 
the assign entry is to actually assign a return value for the set function. Thecall to 
this entry is equivalent to: 


return_val = fn_name$fn_name_assign (); 
Two restrictions on arguments to nonstandard functions are: 


1& No * extents are permitted. 
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es Data types are restricted to those data types permitted in a MRDS data 
base. The use of pointers, entries, labels, structures, offsets, and 
arrays is not allowed. 


Example of the pli source for a scalar function: 
user substr: proc(character argument) returns(char(6)); 


del character argument char(30); 
del substr builtin; 


return(substr(character argument, 1, 6)); 


end user_substr ; 


Example of pli source for a set function: 
standard deviation: proc; 


del number _of calls fixed binary internal static; 
del (sum_of_x, sum_of_x_ square) float decimal(59) internal static; 
del (input parameter, return value) float decimal(59); 


return; /* This entry point is only 
used for declaring the 
set function. */ 


standard deviation init: entry; 
i /* “Entry to initialize static data. 
This entry is used once before 
each evaluation of the set 
function. *#/ 


number of calls = 0; 
sum_of x = 0.0; 
sum_of x Square = 0.0; 
return; 


standard deviation cale: entry(parameter) ; 
= /* “Accumulate the needed 
information from the 
set of data. This entry 
point is called once for 
each row retrieved. */ 


number of calls = number_of calls + 1; 
sum_of x = sum_of x + parameter; 
sum_of x square = sum of x square + 

(parameter ** 2); 
return; 


standard deviation assign: entry returns(float decimal(59)); 
/* “This entry is called when 
there are no more rows 
to be looked at. It 
determines what the final 
value of the set function 


will be. #/ 
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if number of calls > 1 then 
return value = ((number of calls * 
= sum of x square - 
sum of x ** 2) / 
(number of calls * (number of calls 
- 1))) ** .5; 
else 
return value = 0.0; 


return(return value); 


end standard deviation; 
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SECTION 3 


DATA BASE CREATION 


LINUS was designed primarily to allow users to access a centralized MRDS 
data base. However, it is also possible for users to define private data bases 
and utilize LINUS to access and maintain them. Users who wish to define a data 
base should refer to the MRDS Reference Manual, specifically to the introductory 
portion and to the description of the create mrds_ db command. 


Certain differences in terminology between LINUS and MRDS are: 


A MRDS relation is a LINUS table. 
A MRDS tuple is a LINUS row. 


A MRDS attribute is a LINUS column. 


A MRDS domain is a LINUS domain and is the set of values that an 
attribute (column) may assume. 


An example of the dept store data base, discussed in Section 1, may be 
created by invoking a text editor and creating the source segment, dept_store.cmdb: 


domain: name char (30) unal, 
emp no fixed bin (17) unal, 
dept char (12) unal, 
sal fixed dec (13,2) unal, 
comm fixed dec (13,2) unal, 
item fixed bin (35) unal, 
vol fixed bin (35) unal, 
supplier char (30) unal, 
floor fixed bin (8) unal, 
type char (4) unal;_ 


attribute: 
mgr emp no; 


relation: emp (name* emp_no dept mgr sal comm) , 
sales (dept* item* vol), 
supply (supplier* item*® vol), 
loc (dept* floor), 
class (item* type); 
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Then the data base may be created by invoking the command: 


create mrds db dept store dept store -list 


The dept store data base is now ready for loading, using the LINUS store request. 
(See linus command "store request" in Section 5.) 


NOTE: LINUS can also open a data base from a submodel. (Refer to the 
create mrds dsm command in the MRDS manual for a description of 
submodels, and their creation.) 
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SECTION 4 


REPORT WRITER 


SYSTEM OVERVIEW 


The LINUS report writer produces formatted reports from a relational data 
base. Through this facility the user can control: 


* page width and length 


: page breaks 

e page, group, and row headers/footers 

e counts, subcounts, totals, and subtotals 

s hyphenation of overlength values 

6 reordering and excluding selected columns 

e duplicate suppression 

s column alignment, editing, folding, separators, titles, and widths 
e sorting on one or more columns | 

s directing of the report to the terminal, a file, or an io switch 
@ norizontal and vertical scrolling through the report 


The report writer is designed to serve the needs of the casual and experienced 
user. A caSual uSer can have a default report layout provided by the system, 
while an experienced user can precisely define the report layout. 


Basic Operation 


The report writer system retrieves rows of information (tuples) from a 
relational data base and produces a formatted output report. The rows retrieved 
are specified via a selection expression. (Refer to Section 1 for additional 
information and selection examples.) 
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Formatting Options 


A formatted report is produced under the control of "formatting options." 
Formatting options consist of a name (for identity) and a set value. An example 
of a formatting option is: 


-page width 80 


where -page width is the name of this option and "80" is the set value associated 
with the name. Formatting options which deal with columns require an "option 
identifier" to uniquely identify the column. For example, to set the width of a 
column, an identifier is needed to determine which column the width is to be set 
for. Identifiers can be given as the number of the column in the query, the 
name of the column as defined in the open model or submodel, or a star name 
which is matched against the column names. Examples of formatting options with 
identifiers are: 


-width salary 10 
~folding 3 fill 
-alignment ** center 


The formatting options are grouped into the following classifications: 


general report options 
control the overall characteristics of a report. They are assigned 
default values when linus is first invoked, but can be changed by the 
user at any time. These values are retained for the entire linus 
session. General report options consist of: 


-delimiter 

-format document controls 
-hyphenation 

-page footer value 

~page _ “header value 

-page length 

~page width 

-title line 

~truncation 


general column options 
control the overall characteristics of the columns, such as examining 
the value of certain columns to determine if a page break is to be 
generated. They are assigned default values for every new query, but 
can be changed by the user at any time. These values are retained 
only during the current query (i.e., until the next new query is generated). 
General column options consist of: 


-column_order 

-count 

-exclude 

-~group 

-group footer trigger 
-group_ ~ footer value 
-group_ ~ header _ _trigger 
-group_ ~ header _value 
-outline 

-page break 

“row _Tootver value 
-row_ header value 
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-subcount 
-subtotal 
-total 


specifie column options 
control the characteristics of one specific column. They are assigned 
default values for every new query, but can be changed by the user at 
any time. These values are also retained only during the current 
query (i.e., until the next new query). These formatting options require 
an identifier to determine which column the particular option applies 
to. Specific column options consist of: 


-~alignment 
-editing 
-folding 
-separator 
-title 
-width 


The values of formatting options are listed and set through use of the 
list format options and set format options requests. These requests take control 
arguments which are the names of the formatting options. For example, to determine 
the current page width, enter: 


list format options -page width 
and to change page width, enter: 
set format options -page width 71 


A concept of "active" options is employed to make the system easier to use 
and to provide flexibility. For example, if a novice user does not set page 
headers, then no reference is made to them. If a user defines a page header, it 


= seh mee 


then becomes active and appears in the output of the various reporting requests. 
If a user decides to eliminate a previously set page header, that is, by invoking 
the "set format options -page header value -default", it reverts back to the 
"inactive" state. This concept reduces the number of options listed when the 
user invokes the list format options request with no control arguments. The 
page header value is not listed if set to its default value as previously described. 


Specific column options are active at all times, whereas general column 
options and general report options are active only when tneir value is set 
different from the original default value. For example, if the page width is 
assigned its default value by the system, or is reverted to by the user, it is 
not active. The moment that it is changed to a value different from its default, 
it is considered active. 
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Requests 


A number of requests are available for use in the creation of reports. 
Following is a brief summary of the report requests (refer to Section 5 for a 
detailed discussion of all requests): 


column value 
returns the value of the specified column for the current row, previous 
row, or the next row. 


display 
retrieves selected data, creates a report, and displays the information 
or writes it to a file or an io switch. 


display builtins 
returns the current values for requested built-ins. 


format line 
returns a single, quoted character string, formatted from an ioa_ control 
String. 


list_format_options 
displays the names and values of formatting options. 


ltrim 
returns a character string trimmed of specified characters on the left. 


picture 
returns one or more values processed through a specified PL/I picture. 


restore format options 
restores saved report layouts. 


rtrim 
returns a character string trimmed of specified characters on the right. 


Save format options 
saves current values of formatting options for future use. 


set format options 
changes/sets report formatting options. 


string 
returns a Single character string formed by concatenating all of its 
arguments together, separated by single spaces. 
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DEFAULT REPORT ELEMENTS 


Page Layout and Titles 


A page consists of a title line followed by as many rows as fit on the 
remainder of the page. The default title line is made up of one or more column 
titles, one column title for each column on the page. The column title is the 
column name (attribute name), which is found in the open submodel or model. If 
the column is the result of an expression or function invocation, the column 
title is "eN", where N begins at 1 and increases by 1 for each function invocation 
or expression encountered in the query. The row is made up of one or more 
columns, all concatenated together to form the row. The page width is 79 character 
positions and the page length is 66 lines, with 3 of these lines, at the top and 
bottom, reserved for margins. 


Separators 


A separator is provided for each column value and each column title. The 
default separator is two blanks placed between each pair of column titles and 
column values. The last column title or column value of a row has no separator. 


Folding and Width 


Sometimes when formatting a report, the user finds that the report elements 
do not fit within the defined width. To rectify this situation, "folding" takes 
place. Folding can occur in two different ways. The first is "truncation." 
Truncation means that the value is truncated to the defined width and the last 
displayable character is replaced by the truncation character(s) (normally "*"), 
The second is "filling." Filling means that portions of the value are moved 
down to the next line(s), allowing the newly formatted value to appear within 
its defined width. The format document subroutine (described in the Subroutines 
Manual) is used to provide filling of overlength values, and format document 
controls can optionally be supplied to provide greater control over the filling 
action. Filling takes place when a value is wider than its display width; when 
the value contains vertical tabs characters, horizontal tab characters, backspace 
characters, or newline characters; or when the alignment mode is set to "both." 
When column values do not have editing requests associated with them, the value 
is trimmed first (i.e., before the test for filling is done). Character and bit 
data types have trailing blanks trimmed, and all other data types have leading 
and trailing blanks trimmed. 


The default width for a column value is derived from the open model or 
Submodel. The width chosen is the exact number of characters needed to contain 
the value after it is converted from the internal data base data type, to character 
format, via PL/I conversion rules. When the default width is used, the column 
value always fits, but this width can be reduced by the user. The reduction of 
the column width can cause folding to occur. Column folding can be set to 
"fill" or “truncate" and proceeds as described above. The default for column 
values is "fill." 


The concatenation of all coiumn values and separators (used to determine 
row value) can cause row folding to occur. This happens when the resulting row 
is wider than the defined page width. In this case, columns which appear on or 
to the right of the right page boundary are moved down to the next line(s). The 
corresponding titles are moved so that they appear directly over the columns. 
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Columns whose widths are greater than the page width are automatically reduced 
to the page width. 


Alignment 


The alignment for column values is derived from the data type of the column, 
as defined in the open model or submodel. Character and bit strings default to 
"left alignment," decimal data with a non-zero scale defaults to "decimal point 
alignment," and all other data types default to "right alignment." The user can 
set the alignment of individual columns to left, right, center, both, or decimal 
point alignment. 


The alignment for a column title is center (i.e., the title is centered 
within its defined width). 


The alignment for a title line or a row is left (i.e., the title line or 
row is placed against the left page boundary). 


OPTIONAL REPORT ELEMENTS 


A number of optional features (for greater control over report appearance) 
are available for more sophisticated report formatting. These optional features 
are: 
editing 
headers/footers 
column titles 
active requests 
page breaks 
excluding columns 
ordering of columns 
grouping 
outlining 
totals and subtotals 
eounts and subcounts 


separators and delimiters 


embedded control lines and hyphenation 


iti ed for any column value, and is provided by linus 
active requests and Multics active functions. The column value request is used 
to pass the value to other active requests, and the returned value is then 


~ h + 
uBs can ve Speci 
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folded and aligned as described above (see "Folding and Alignment"). The report 
writer does not strip a level of quotes from the editing request; the first time 
quote stripping occurs is when ssu $evaluate active string subsystem utilities 
procedure is invoked. Editing of column values is not provided by default. 


Headers/Footers 


A header or footer is a character string provided by the user. The character 
String can contain active requests, be made up of more than one "portion," and 
consist of more than one line. A delimiter character is used to separate the 
different portions of a header or footer. The delimiter character default is 
"i", but can be changed by the user. THe header/footer can consist of a left, 
right, and center page portion. 


Evaluation of a header/footer is a two-part operation that proceeds in the 
following manner: first, the header/footer is divided into its portions based 
on the delimiter character; and second, active requests are evaluated. Quote 
Stripping is not done by the report writer during these two operations; the 
first time quote stripping occurs is when the ssu $evaluate active string subsystem 
utilities procedure is invoked. The linus display_ builtins active request can 
be used to obtain built-ins like the current page number in a header/footer, and 
the linus column value active request can be used to obtain the value of a 
column. 


A header or footer can be made up of a left, right, and center page portion. 
These portions are determined by the delimiter characters. The portions are 
aligned to the left, right, and center of the page. Folding on headers/footers 
proceeds independently for each part. Portions of a header or footer (left, 
right, or center) with zero length are redistributed to other portions whose 
lengths are not zero. For example, if the page header contained only a center 
portion as: 


!'!Sample Center Portion!! 


the text would be centered on the page, but would have the full page width 
available for the text. Similarly, a left portion or right portion only is 
aligned to the left or right of the page, but has the full page width available 
for placement of its text. Two exceptions to this action are when the header or 
footer has a left, right, and center portion, and the left or right portion has 
a zero length. For example: 


!left part!center part!! 
or 
!!center part!right part! 


In both cases the left or right part of the page is unavailable for placement of 
text (i.e., the space is not redistributed to the other two portions). 


If redistribution of the available page width is not desired, the placement 
f a single blank into a portion prevents the redistribution from taking place 
Bus : 


££. DOFtTLon 


tion haS a length greater than zero. For exampie: 


¢ 
uw 
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= 
a 


! !Center Part! ! 


Headers and footers can be defined for a page, group, and a row. The first 
row that appears on the page is available for the page header, and the last row 
that appears on the page is available for the page footer. The first row of a 
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group is available for the group header, and the last row of a group is available 
for the group footer. The current row is available for use in the row header 
and row footer. 


Column Titles 


A column title is a character string that is placed above its associated 
column. The display width available for the title is inherited from its parent 
column, along with the folding action. If the title is exactly the same number 
of characters as the display width, it is placed without any folding or alignment 
action. If the title is shorter, it is centered within the display width. If 
the title is wider, it is truncated or filled, depending on its parent column's 
setting. 


a 


Active Requests 


Active requests are used in headers/footers to substitute values into the 
header/footer at the time the report is being formatted. For example, the Multics 
date active function can be used to provide the current date as part of the 
header or footer. 


Active requests are also used to provide editing for column values which 
become part of the row value. For example, the linus picture active request can 
be used to provide editing features such as dollar signs and commas. 


The user specifies linus active requests through the construct "[name STR]", 
where name is the name of the desired active request and STR is any argument(s) 
required by the active request. Multics active functions are invoked via the 
linus [execute] active request. They are specified by the user through the 
construct [execute name STR], where name is the name of the Multics active 
function and STR is any argument(s) required by the active function. The active 
function/request is evaluated and its returned value is substituted into the 
original string before folding and alignment take place. 


Page Breaks 


Page breaks can be set to occur when the value of one or more columns 
change. The occurrence of a new value in the column(s) being examined closes 
out the current page and a new page is started. The new row which caused the 
page break is not made available until the start of the next page. This allows 
the page footer to access the correct row (the last row on that page). 


Excluding Columns 


Columns selected in the query can be excluded from the row value. Through 
use of the [column value] active request, the column value can be obtained for 
placement elsewhere on the page. For example, a user may exclude the display of 
a column that is being used to determine when to generate page breaks, and place 
the value of the column in the page header with the column value active request. 
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Ordering Of Columns 


Columns appear on the page in the order they were selected in the query. 
This order can be changed by the user without having to go back and change the 
query. 


Grouping 


One or more columns can be used to define a "group" of rows based on the 
values of these columns. The named columns make up a major to minor hierarchy 
and can be used in conjunction with the outlining, page break, subtotal, and 
subcount features. 


Outlining 


One or more columns can have duplicate values suppressed. If the value of 
the current column is the same as the previous value, then its display is suppressed 
unless it is the first line on a new page. 


If any named column is a member of the group of columns defined via the 
grouping feature, it and any columns more major in the hierarchy are outlined. 
A change in value of any one column displays all values of columns lower in the 
hierarchy in addition to the changed column. An exception is the first line on 
a new page, when duplicate values are never suppressed. 


Totals and Subtotals 


Totals and subtotals can be specified for columns. The totals and subtotals 
are placed directly under the associated columns. 


A column subtotal is generated when the value of the column(s) the subtotal 
is associated with changes. The subtotal can be associated with one or more 
columns. Several subtotals can be specified, each associated with different 
columns. Subtotals can be "reset" or "running." A column total is generated 
after the last input row is processed. 


The width, alignment, folding, and editing request for a totai or subtotal 
is inherited from its parent column. During the generation of a total or subtotal, 
the column value request returns the value of the total or subtotal, rather than 
the column value. When the parent column is excluded from the page, the total 
or subtotal associated with it is also excluded. An exception to this rule is 
when all of the columns have been excluded. They are provided in this case to 
produce reports containing some combination of subcounts, subtotals, counts, and 
totals only. 


Counts and Subcounts 


Counts and subcounts can be specified for columns, and work as described 
above under "Totals and Subtotals." A count or subcount counts occurrences of 
values, whereas a total or subtotal accumulates values. 
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Separators and Delimiters 


The separators used to separate column values and column titles from each 
other can be set to any string of displayable characters by the user. The 
delimiter character used to delimit the different portions of a header/footer 
can aiso be set by the user. 


Format Document Controls and Hyphenation 


NE | NT 


The report writer uses the format document subroutine (refer to the Subroutines 
Manual) to "fill" overlength text. A user can embed format document control 
lines in text to achieve greater control of the filling action. A user can also 
specify that hyphenation of words should be attempted when filling overlength 
text. 


FULL PAGE FORMATTING 


The report writer system formats a full page before any output is provided. 
It operates in this fashion because it is sometimes necessary to back up on a 
page and defer report elements to the next page so that associated report elements 
remain on the same page. A full page with all report elements present is outlined 
in the following diagram. 


Formatted Page 


PAGE HEADER 
TITLE BLOCK 
DETAIL BLOCK 1 


#- expanded in diagram below 


DETAIL BLOCK N 
PAGE FOOTER 


Detail Block 


a 


GROUP FOOTER 


All of the defined report elements are optional, but at least one must be 
present or a zero length page is the result. A zero length page is treated as 
an error and the report formatting is terminated. 


Backing up on a page is accomplished via a detection/prevention method, and 
proceeds as follows: 


The page header, if present, is processed first. If the page header 
does not fit on the page, it is treated as an error and the report 
formatting is terminated. The formatted page header can fill the complete 
page if no other report elements are defined. 


The title line, if present, is processed next. If the title line does 
not fit on the page, it is treated as an error and the report formatting 
is terminated. The formatted title block can fill the complete page 
if no other report elements are defined. 


The detail block is processed next. A detail block can be made up of 
a group header, a row header, a row value, a subtotal block, a subcount 
block, a total block, a count block, a row footer, and a group footer. 
These different elements are treated as one unit and must all appear. 
on one page or the detail block is deferred to the next page. If any 
of these elements are defined, then at least one detail block must fit 
on the page or it is treated as an error and the report formatting is 
terminated. The formatted detail block can fill the complete page if 
no other report elements are defined. 


a. The group header, if present, is processed first. If the current 
row is the first row of the report, or if the column associated 
with the -group header trigger option has just changed with the 
current row, the header is generated. If the group header does 
not fit on the page, the detail block is deferred to the next 
page, provided one detail block is already placed on the page. 


b. The row header, if present, is processed next. If the row header 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. 


Cc. The row value, if present, is processed next. If the row value 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. The editing requests associated with any columns are evaluated 
before an attempt is made to place the row value on the page. If 
the row value is deferred to the next page for any reason, the 
editing requests associated with the columns are evaluated again 
when the row value is processed on the next page. This is necessary 
to ensure that obtained values, such as the page number display 
built-in are correct. For users who are doing calculations based 
on accumulations, this could produce incorrect calculations. That 
is, the value of a row could be accumulated more than once. The 
previously processed row display built-in provides a mechanism to 
ensure this does not happen. If the value of this built-in is 
true, a user doing accumulations would not add in the current row 
value aS it was already added in when the editing requests for 
the row were processed the first time. 


d. The row subtotal, if present, is processed next. If subtotal 
generation is necessary, and the row subtotal does not fit on the 
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page, the detail block is deferred to the next page, provided one 
detail block is already placed on the page. The editing requests 
associated with any subtotals are only evaluated when subtotal 
generation is done, and proceed as described above under "row 
value" editing requests evaluation. The previously processed row 
display built-in also works as described above. ~ 


e. The row subcount, if present, is processed next. It proceeds as 
described above under row subtotal (item d). 


fs The row total, if present, is processed next. If total generation 
is necessary, and the row total does not fit on the page, the 
detail block is deferred to the next page, provided one detail 
block is already placed on the page. The editing requests associated 
with any totals are only evaluated when total generation is done, 
and proceed as described above under "row value" editing requests 
evaluation. The previously processed row display built-in also 
works as described above. —_ 


g. The row count, if present, is processed next. It proceeds as 
described above under row subtotal (item d). 


h. The row footer, if present, is processed next. If the row footer 
does not fit on the page, the detail block is deferred to the 
next page, provided one detail block is already placed on the 
page. 


Ls The group footer, if present, is processed last. If the current 
row is the last row of the report, or the column associated with 
the -group footer trigger option is about to change with the next 
row, the footer is generated. If the group footer does not fit 
on the page, the detail block is deferred to the next page, provided 
one detail block is already placed on the page. 


The page footer, if present, is processed last. If the page footer 
does not fit on the page, the last detail block on the page is removed 
and the page footer is processed again. Active requests found in the 
footer are evaluated again to ensure correct processing of display 
built-ins like current row number. If the page footer still does not 
fit, another detail block is removed from the page and the footer is 
evaluated again. This process continues until the footer fits, or 
there are no more detail blocks to remove from the page. The first 
detail block that appears on the page is never removed, and if its 
removal is necessary to provide a fit for the page footer, it is 
treated aS an error and report formatting is terminated. 
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USER SESSION 


The remainder of this section consists of report writer examples organized 
into a sample user session. User-typed lines and lines displayed by the system 
are shown together in the example. To differentiate between these lines, an 
exclamation mark (!) precedes user-typed text. This is done only to distinquish 
user text from system-generated text; it is not to be included as part of the 
input line. Also, a “carriage return" (moving the display mechanism to the 
first column of the next line, called a newline or NL on Multics) is implied at 
the end of every user-typed line. Line numbers are also included in the examples 
for purposes of commentary immediately following the example. 


Note: Because of page constraints in this document, certain character 
Strings of data used in examples may not match exactly the information 
as seen on a user's terminal. That is, the character strings in 
examples may be folded or multiple-lined, whereas the actual 
interactive (live) session may display the same information on a 
Single line or multiple lines with different line breaks than 
Shown here. Additionally, blank lines have been removed in the 
examples for space consideration in this document. In most cases 
this can be recognized by the reader. For example: 


55 ! linus: display -page 1 
59 (system display) 
Only one space is used to separate the two lines in the example, 


but the line numbers to the left of the lines imply there are 
actually three spaces here. 


Following is a list of request and control argument abbreviations used in 
the examples. They are included here for the purpose of saving the reader from 
referring to other sections if a term is unfamiliar. 


REQUEST ABBREVIATIONS 


clv column value 

di display 

dib display builtins 

e execute | 

ec exec com 

iq input query 

ldb list db 

ls list (Multics command level) 
lsfo list format options 

Oo open ~ 

pr print (Multics command level) 
q quit 

rsfo restore format options 

sfo set format options 

ss set scope 

svfo save format options 

tq translate query 


PAN AS ry 2 . eRe mere 8 wee ns 


CONTROL ARGUMENT ABBREVIATIONS 


-a -all 

-al -alignment 
-bf -brief 

=Cco -column order 
-dm -delimiter 
-ed -editing 
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8/36 


~e@X 
-fe 
-fold 
-gft 
-gfv 
-ght 
-ghv 
-gr 
~it 
-Kr 
-krp 
-nr 
-of 
-or 
-orp 
-out 
-pbdb 
-pfv 
-pg 
~phv 
-pl 
-pw 
-rfv 
-rhv 
-rs 
-se 
-sep 
-stt 
-te 
~td 
-ti 
-tl 
-tt 
-ttl 
-wid 


~exclude 

-force 

-folding 
-group_footer_trigger 
~group_ footer_value 
-group_header_trigger 
-group_header_ value 
-group 

-iteration 

-keep retrieval 

-keep report 
~new_retrieval 
-output file 

-~old retrieval 

-old report 

-outline 

-~page break 

-page footer value 
-page 

-page header _value 
-page length 

~page width 

-row footer value 
-row_ header value 
-reset = 
~selection expression 
-separator 

-subtotal 


-truncation -OR=- -truncate 


-temp dir 
~terminal input 
-title line 
-total 

-titile 

-width 
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General 


Fwnh- 


on 


Report Options-1 


linus -it 


linus: o employee r 
linus: ss employee r u 
linus: Ildb -lg 
TABLE ~ COLUMN DECLARATION DOMAIN TYPE 
employee (perm) 
name name 
char (10) key 
job job 
fixed dec (2) unal key index 
Salary Salary 
fixed dec (7,2) unal data index 
age age 
fixed dec (2) unal data index 
sex sex 
char (1) key index 
family family 
char (1) data 
state State 
char (2) data index 
city city 
char (13) data index 
linus: lsfo -a 
-delimiter bt 
-format document controls "off" 
-~hyphenation a "off" 
-page footer value an 
-page header value ye 
-page length "66" 
-~page width n7gn 
-title line "on" 
~truncation nen 
linus: Il1sfo 


All of the formatting options are set to their 
There are no column options defined. 


linus: sfo -pw 0 
linus: lsfo 
~page_ width bal 8 

linus: sfo -pw -default 

linus: Ilsfo 

All of the formatting options are set to their 
There are no column options defined. 


default values. 


default values. 
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line 1-4 
Invoke linus, open, set scope, and list information about the data base. 


line 5 
List the names and values of "all" report formatting options. All of 
the displayed values in this case are "default" values. These options 
are the "general report options." They remain in effect across the 
entire linus session. For example, if the page width is changed, it 
remains at this new value until it is explicitly changed back, or until 
the linus session is terminated. 


-dm A character used to delimit portions of header/footer. 


-fde "off" used when filling overlength character strings. If 
"off," ignore embedded controls. 


-hyphenation "off" used when filling overlength character strings. If 
. "off," do not attempt to hyphenate words. 


=piv. om footer placed at bottom of each page. 

-phy header placed at top of each page. 

-pl "66" length of each formatted page (number of lines). 

-pw "7g width of each formatted page (number of character 


positions). 


-tl fon" print the title line. 
-tec wen eharacter that indicates truncation has occurred. 
line 6-10 


List options, set page width, list options again, reset page width, and 
list options once again. If line 10 included the -all control argument, 
the display would be the same as that following line 5. 
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Specific Column Options 


The following example looks at "specific column options." 
always listed and are assigned new default values each time a new query is processed. 


linus: iq -bdf 
select * from employee 


linus: tq 

linus: 1sfo 
-alignment age 
-alignment city 
-alignment family 
-alignment job 
-alignment name 
-alignment salary 
-alignment sex 
-alignment state 


WN Fw hw = 


14 -editing 
-editing 
-editing 
-editing 
~editing 
-editing 
-editing 
-editing 


age 
city 
family 
job 
name 
salary 
sex 
state 


22 -folding age 
-folding city 
-folding family 
-folding job 
-folding name 


-~folding 
-folding 
-folding 


Salary 
sex 
state 


30 -separator age 
-separator city 
-separator family 
-separator job 
-separator name 
-separator salary 
-separator sex 
-~separator state 

38 -title age 
-title city 
-title family 
-title job 
-title name 
-title salary 
-title sex 
-title state 

46 -width age 
-width city 
-width family 
-width job 
-width name 
-width salary 
-width sex 

53 ~width state 
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"right" 
"left" 
"left" 
"right" 
"left" 
"decimal 8" 
"left" 
"left" 


wt 

999 , 

Te 08 

999 

wnt 

ee 

at 

wi 
mfili" 
"fill" 
"fill" 
"fill" 
"pili" 
"fill" 
"fill" 
"fill" 


" " 


Ww ag ae" 
Noeit ? 
"family" 
"job nt 
"name" 
"salary" 
" sex wt 
"state" 
us) " 


w4gN 


Lm | " 
"won 
nyoNu 
"yo." 


"4 " 


"oO " 


4-18 AZ49-03A 


These options are 


line 1-5 
Invoke input query, build query, translate query, and list the names and 
values of the column options. 


line 6-13 
System display -- the alignment option specifies how a value is to be 
aligned within its display width. 


2 Character and bit strings default to left-alignment. 


e Decimal data with a non-zero scale defaults to 
decimal-point-alignment. 


* All other data types default to right-alignment. 


line 14-21 
System display -- the editing option provides additional editing for 
column values. (Default is no editing) 


line 22-29 
System display -- the folding option specifies the action taken when the 
column value exceeds the display width for the column. (Default is. 
ag a 


line 30-37 
System display -- the separator option specifies the character string 
that separates the specified column from the following column. (Default 
is two blanks) 


line 38-45 
System display -- the title option specifies the character string to be 
Placed at the top of the page above the column. (Default is the name 
found in the open model or submodel) 


line 46-53 
System display -- the width option specifies the display width of the 
detail line of the column. (Default is the number of characters needed 
after conversion to character format) 
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The following examples look at a report utilizing the available specific 
column options. 


age 


o 


B53 5 5 


See 3S mW eh 


uQausgagyn 


St 
at 


city 


juneau 
phoenix 
fresno 
sacramento 
los angeles 
san diego 

san francisco 


Springfield 


Data is retrieved from the data base and formatted by 


55 ! linus: di -pg 1 
59 name job salary 
66 abel 1 14555.01 
67 abell 2 13000.01 
68 abernathy 3 12500. 01 
69 abodoura 5 12900. 01 
70 aboe 4 10201.01 
71 abraham 6 15000. 01 
Te abrahms 7 14300. 01 
- (45 data lines) 
118 baker 1 12000. 10 
line 55 
Display page 1. 
default parameters. 
line 59-118 


System display 


120 ! linus: I1sfo -wid state 
-width state non 


123 ! linus: sfo -wid state 5 
125 ! linus: di -pg 1 


129 name job Salary age s f state city 
e a 
x m 
i 
1 
y 
136 abel 1 14555. 01 36 m s_ ak juneau 
137 abell 2 13000.01 65. f£. Mm az phoenix 
138 abernathy 3 12500. 01 61 m dé ea fresno 
139 abodoura 5 12900.01 61 m m ea sacramento 
140 aboe 4 10201.01 41 f S ea los angeles 
141 abraham 6 15000. 01 25 f d ea san diego 
142 abrahms 7 14300. 01 35 m S ca san francisco 
(45 data lines) 
188 baker 1 12000. 10 i 2 as ee a | springfield 


Tee eS TT OSE SB SO ee SE Oe eM ew EO Ee Ewe Se wwe OO See ewe ewe wee ee wBewoeees ewe eseee2ewwrerewwe esr e2wreer owe wee = 


line 120 
List the width value of the "state" column. 


line 123-125 
Set the width value for state column to "5" from its default value of 
wo" and display page 1. 


line 129-188 


System display -- note the difference in the state column header on line 
129 from that displayed on line 59-61. 
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190 ! linus: Ilsfo -wid 8 
-width city so Oa fa 
193 ! linus: sfo -wid 8 10 
195 ! linus: di -pg 1 
199 name job Salary age s f state city 
e oa 
x m 

i 

1 

y 
206 abel 1 14555.01 36 m sak juneau 
207 abell 2 13000. 01 55 f m az phoenix 
208 abernathy 3 12500. 01 61 m dé ea fresno 
209 abodoura 5 12900. 01 61 m m ceca sacramento 
210 aboe y 10201. 01 41 f S ca los 
211 angeles. 
212 abraham 6 15000. 01 25 f. d ca san diego 
213 abrahms 7 14300. 01 35 m Ss ca san 
214 francisco 

(37 data lines) 
252 arnold 22 18210.01 53 f d pa philadelph. 
253 ia 
254 ashman 23 12400. 01 52 m s tn chattanoog 
255 a 
256 ashworth 24y 9301.01 61 f m tx austin 
257 asin 1 15100. 01 51 m d tx dallas 
258 auburn 2 13101.01 10: &t -<S° 2% rutland 
line 190 


List the width value of column 8 (city) 


line 193-195 
Set the width value of the 8th column to "10" 
"13" and display page 1. 


from its default value of 


line 199-258 
System display -- note the difference under the city header (line 210-214) 
from that displayed on line 140-142. Also notice the not-so-pleasant 
breakup of line 252-255. This is an example of column "filling." 


AZ49-03 


260 ! sfo -wid 8 -default;lsfo -wid name 
-width name "70" 
263 ! linus: sfo -wid name 7 -fold name truncate 
265 ! linus: di -pg 1 
270 name job salary age s f state city 
e a 
x m 
i 
1 
y 
277 abell 2 13000.01 55 ff m az phoenix 
278 aberna*® 3 12500. 01 61 m dé ea fresno 
279 abodou® 5 12900. 01 61 m m ea sacramento 
280 aboe 4 10201.01 B41. -f “Ss: ea los angeles 
(47 data lines) 
328 baker 1 12000. 10 Tl. tm. <s. “1 springfield 
line 260 


Set the width value of column 8 (city) to its default value (13) and list the 
width value of the name column. Notice that multiple linus requests can be 
included in a single request line by utilizing the request termination 
character (;) between requests. Any number of requests may be included ona 
line using this format. 


line 263-265 
Set the width value of the name column to "7", truncate the data listed under 
the name column, and display page 1. 


line 269-279 


System display -- note the difference under name header (line 278-279) from 
that displayed on line 208-209. 


we ee we OO 08 oe a oe oe ee ee ee ee eo ee es Pe ee oe oe ee se om we we we we we we we oe we es ee we ow we ow ws ee ee ew ne we ee ew 


330 ! sfo -sep ** " | " 


332 ! linus: di -pg 1 
336 name { job | salary i age }si{f {4 state } city 
i H 1 ;etat H 
H H ix tm 4 q 
H i i H iii 
H 1 H H i 14 H 
H H i i i yi H 
343 abel : ae 14555.01 | 36 | misi ak i juneau 
344 abell H 2 | 13000.01 } 55 i fim i az | phoenix 
345 aberna® | 3 12500.01 |} 61 | mtd ea | fresno 
346 abodou* | 5 12900.01 | 61 | m {| mt ca | sacramento 
347 aboe H yf 10201.01 | 41 | f | st ea | los angeles 
: (47 data lines) 
395 baker i 1 | 12000.10 } 71 i} mis? il | springfield 
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line 330-332 


Set the column separator value to "<SP>{<SP>" from its default value of 
<SP><SP> (two blanks) and display page 1. 


line 336-395 
System display -- note that the columns have shifted to the right because the 
separator was increased to three character positions. Previous example 
separators were only two character positions. 


age 


s | f | state | city 
etal 1 
x | m 4 H 

i ij i 

ili i 

ae ae H 
mis it ak | juneau 
f | mj} az | phoenix 
midi ca | fresno 
m{m { ca } Sacramento 
mis; il i springfield 


397 linus: sfo -al age left -ed salary -prompt 
398 Enter -editing salary. 
399 [pic $zz,zz9v.99 [eclv salary]] 
400 ‘ 
402 linus: di -pg i 
406 name i job .} salary 
i] ' i] 
P| 3 
i i 
i i i 
413 abel 1 | $14,555.01 | 
abell H 2 1 $13,000.01 ; 
aberna*® } 3 1 $12,500.01 | 
abodou® | 5 | $12,900.01 ; 
- (48 data lines) 
464 baker H 1; $12,000.10 |; 
line 397 


Set alignment value for age column to 
"right," and invoke the editing option 


line 399-402 
Edit request, termination, and display 


line 406 =~ 464 
System display -- note that the information under the age column is now 
aligned to the left of the column and the data under the salary column contains 
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the "$" and "," characters. 
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"left" from its default value of 
with prompt. 


page 1. 


AZ49-03A 


466 ! linus: lsfo -ttl ** 


-title age Nagel 
-title city "eity™ 
-title family "family" 
-title job "job" 
-title name "name" 
-title salary "salary" 
-title sex "sex" 
-title state "state" 


476 ! linus: sfo -al age -default;sfo -ttl (1 2 3 4 5 6 7 8) -prompt 
NTT Enter -title name. 
478 ! NAME 

u79 !. 

480 Enter -title job. 
481 ! JOB 

482 1. 

483 Enter -title salary. 
484 ! SALARY 

485 1. 

486 Enter -title age. 
487 ! AGE 

488 ! . 

489 Enter -title sex. 
490 ! SEX 

yQoi fi. 

492 Enter =-title family. 
493 ! FAMILY 

yoy '. 

495 Enter -title state. 
496 ! STATE 

4HO7 !. 

498 Enter -title city. 
499 ! CITY 

500 ! . 


502 ! linus: di -pg 1 
SALARY 


506 NAME } JOB } i; AGE {| S {| F j STATE } CITY 
i 1 EY At 
1 i X i Mt i 
i i ; Ij 
be 4 
i i 1 Yj 
abel H 1 + $14,555.01 } 36 | mj; s } ak ;} juneau 
abell H 2 + $13,000.01 }; 55 | f i mj az i phoenix 
aberna*® | 3 + $12,500.01 | 61 | m | d j ea i fresno 
- (49 data lines) 
565 baker H 1 | $12,000.10 } 71 i mjs y7{ iil } Springfield 


line 466 
List the titie vaiues of all columns. 


line 476-502 
Set the title value for all columns to new values (in this case, all 
have been changed from lowercase to uppercase), and display page i. 

line 506-565 
System display -- note that the column header values on line 506 are 
different from that displayed on line 406. 
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General Report Options-2 


The following examples look at the "general report options" and are an 
extension to the example shown above under "General Report Options-1." 


1! linus: sfo -pl 26 
3 ! linus: di -pg 1 
7 


STATE 


NAME ; JOB 4} SALARY ;: AGE> feck : CITy 
i i EY Af 
i | 1 X 7M y 
H a 
H i i Lf 
i I ee ae Soe 
abel 1 1 $14,555.01 | 36 } m}s {| ak | juneau 
abell 2 1 $13,000.01 |} 55 f f tom | az | phoenix 
aberna*® | SS le yg DOUS OL =| 61 | mj dj ca | fresno 
- (9 data lines) 
ot agee { 14H | $30,900.01 |} TO: 4 ade eB: SY a ; honolulu 


line 1-3 
Set the page length value to "26" from its default value of "66," and 
display page 1. 


line 7-27 
System display -- note that the report length has decreased. MThere are 
now 20 text lines and three "margin lines" at the top and at the bottom 
of the page. When the report is sent to a file (for later printing), 
these six margin lines are put in the report by the line printer software. 
This produces the same page format, whether viewed at a terminal or on 
hardcopy. 
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29-! linus: sfo =-phv -prompt 
30 Enter -page header value. 


31 ! ![e date]!Sample Report![e time]! 
32 ! ret 
33:20 4s 


35 ! linus: di -pg 1 


39 04/29/83 Sample Report 
NAME | JOB jj; SALARY | AGE tS 4 BN SISTE..4 CITY 
1 EY A | 
{ ; X 7 M 4 H 
I a oe H 
i I aes me 
ie ae 
abel 1 | $14,555.01 | 36 | m | s {| ak | juneau 
abell H 2 + $13,000.01 } 55 | f it mf az i; phoenix 
aberna*® | 3 + $12,500.01 | 61 | midi ca | fresno 
(7 data lines) 
58  adkins j| 11 + $20,700.01 | 75 {mim} fl | key west 


line 29 
Set the page header value when prompted. by the system. 


line 30 
System display -- prompt 


line 31-35 ; . 
Set page header to contents of line 31-32 (two header lines), terminate, 
and display page 1. 


line 39-58 

System display -- note that a page header (line 39) is now included as 
part of the report. This two-line page header reduces the page content 
of the report (i.e., the report now consists of 18 data lines whereas 
the previous example contained 20 lines). The page header fills the 
entire page width, but the column values do not. If the page width is 
set to zero, the display request calculates the page width to be an 
exact fit (i.e., contains all of the column values and separators). 
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cD 


CN 


60 ! linus: sfo -pw 0 
62 ! linus: di -pg 1 


66 04/29/83 Sample Report 10: 26 
NAME : .~§OB. 4 SALARY | AGE | S | F ! STATE } GIy 
H I rE tT Af H 
1 X | M4 
H 1 H i tj i 
i H i bf 
H H bk. 4 
abel i 1 | $14,555.01 |} 36 | m }| s } ak | juneau 
abell H 2; $13,000.01 | 55 1 f | m jf az | phoenix 
aberna® | 3 | $12,500.01 } 61 } m jd} ea | fresno 
- (7 data lines) 
85 adkins | 11 | $20,700.01 } 75 | mim} fl | key west 
line 60-62 
Set the page width value to "0" from its default of "79," and display 
page 1. 
line 66, 85 
System display -- note that the page header is now centered over the 


columns. Setting the page width to zero has one disadvantage: when set 
to some positive integer and a column width exceeds the page width, that 
column width is reduced to the page width. For example, if the page 
width is set to 80 and the width for a column is set to 1024, the column 
width is reduced by the display request to 80. The reduction of a 
column display width does not take place when the page width is set to 
zero. 
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87 ! linus: 


sfo -pfv -prompt 


88 Enter -page footer value. 


89 t SUEY 


90 ! !!- Page [dib page number] -!! 


gi !. 


93 ! linus: 


97 04/29/83 


NAME 


abel 
abell 
aberna*® 
abodou* 
aboe 
abraham 
abrahms 
acee 
114 acord 


di -pg 1 


WO COAAMN LMWwWNM 


Sample Report 


SALARY 


$14,555.01 
$13, 000.01 
$12,500.01 
$12,900.01 
$10, 201.01 
$15, 000.01 
$14, 300.01 
$12, 700.01 
$10,500.01 


AGE 


rs 1M 


2 ee ww ee we 
a ee ee ee ee ee 


Bees) )3S5%38 


MMH Ss PS 


QaBununsBasn 


STATE 


Q 
8) 


ee 


10:26 
CITY 


juneau 
phoenix 
fresno 
sacramento 
los angeles 
san diego 

san francisco 
denver 
hartford 


line 87 


Set the page footer value when prompted by 


line 88 


System display -- prompt 


line 89-93 


the 


system. 


Set the page footer to contents of line 89-90 (two footer lines), terminate, 
and display page 1. 


line 97-116 
System display -- note that a page footer (line 


part of the report. This two-line page footer reduces the page content 


116) is now included as 


of the report by another two lines (now 16 lines of data between header 


and footer). 


H-29 


AZ49~-03 


118 ! linus: sfo -pl -defaultj;di -pg 1 


122 04/29/83 


NAME {| JOB {| SALARY | 
H 

H 

1 i 1 

1 1 I 

i] 1 ' 

t | ! 

H 

abel H Tt $14 5555.01 3} 
abell : 2 | $13,000.01 | 
aberna*® ! 3 1 $12,500.01 } 


(45 data lines) 


AGE 


36 
61 


Sample Report 


s 
E 
X 


MITH Ze 


a 


STATE 


ak 
az 
ca 


va 


10:26 


CITY 


| juneau 
| phoenix 
| fresno 


| norfork 


179 deer | 5 1 $12,600.01 } 
181 = 
line 118 


Set the page length to "default" 


"26" (see line 1 of this example set). 


line 122-181 


(66 lines) from its 


previous setting of 


System display -- note that the page now consists of 66 lines (3 blank 
margin lines at top and bottom and 60 lines of report). 


4-30 


AZ49-03 


183 ! linus: sfo -te <MORE>;di -pg 1 
187 04/29/83 Sample Report 10: 26 
189 NAME | JOB { SALARY | AGE {|S { F } STATE | CITY 
H ae ae ae: ee 
1 1 Xt My 
i] 1 i] ] i T t ! 
i i t { J + I 1 
H i L { 
194 H 1 Y 4 
abel i 1 | $14,555.01 | 36 | m jis { ak {| juneau 
abell ! 2 | $13,000.01 } 55 | f i mt az | phoenix 
198 a<MORE> | 3 | $12,500.01 } 6h a di, +a | fresno 
199 a<MORE> } 5 1 $12,900.01 | 61 |} m {mt ea | Sacramento 
aboe H 4 + $10,201.01 | y1 | f {| S [ ca |} los angeles 
(43 data lines) 
O4y azer H 5 | $12,600.01 } uy | m }|s j va | norfork 
246 - Page 1 - 
line 183 


Set the truncation value to "<MORE>" from its previous default value of 
"¥, and display page 1. Refer to line 263 in the “Specific Column 
Options" example (above) where the width value of the name column was 
set to "7" and the folding option, with truncation (Default = ¥*), was 
turned on for the name column. 


line 187-246 


System display -- note the different truncation of the name column values 
(line 198-199 ) from that displayed in the earlier example identified 
above (line 278,279). 
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248 ! linus: sfo -tl offj;di -pg 3 


252 04/29/83 Sample Report 10: 26 
254  ec<MORED | 3 1 $12,501.01 | 76 | mj m { ca i san francisco 
cummins | 4 1 $10,700.01 |} 76 4. f {od} ee ;} denver 
ecutechin | 5 + $12,600.01 } 62 }; mis jt et | hartford 

(52 data lines) 
309 goodwyn | 15 | $12,400.01 | 39 | f£ | d |} et | hartford 
311 - Page 3 - 


313 ! linus: sfo -tl on 


line 248 
Set the title line value to "off" from its previous default value of 
"on," and this time display page 3. Turning the title line off inhibits 
the column header or title display from that displayed in the previous 
example (line 189-194). 


line 313 


Set the title line value to "on." This restores the display of column 
header or title lines. 


4232 AZ49-03 


SPECIAL EDITING OF A REPORT 


The following example shows how to utilize a user-defined exec com and 
interact with the editing request. 


1! linus: sfo -wid sex 6 -ed sex "Lec sex lookup [clv sex]]" 
3 ! linus: ..ted 
4! oa 
5 ! &version 2 
6 ! &trace off 
7! &if &[e equal m &1] 
8 ! &then &return male 
9 ! &else &return female 
1O-f> “XE 
11! w sex _lookup.lec 
12 ! @q ; 
14 ! linus: di -pg 1 
18 04/29/83 Sample Report 10: 26 
20 NAME ' JOB | SALARY ' AGE | SEX ' F | STATE } CITY 
H H 1 Aj H 
i i i H i Mj t 
H i i i ; If 1 
H 1 H H iL i H 
H H H 1 Y | 1 
27 abel : 1 + $14,555.01 | 36 | male { Ss | ak | juneau 
28 abell H 2 } $13,000.01 | 55 | female | m j} az i; Phoenix 
- a<MORED } 3 + $12,500.01 | 61 } male i; d { ca | fresno 
- (45 data lines) 
75 azer H 5 | $12,600.01 | 44 | male i; s | va ' norfork 
TT - Page 1 - 
line 1 


Set the width of the sex column to "6" from its previous default value 
of "1," and prepare for special editing of the sex column data. 


line 3-12 
Invoke the ted editor, append the following exec com data (line 5-9) 
into the ted buffer, terminate append mode, write the buffer to permanent 
Storage, and quit the ted editor. 


line 14 
Display page 1 
line 18-77 
System display -- note the change in width of the sex column (line 20) 


from that displayed in the previous example (line 189) and the change of 
data by the exec_com (m = male and f = female). 
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SAVING A REPORT AND RESETTING OPTIONS 


Tne following example shows how to save a report after it is in the desired 
format. 
report back to its original format. 


1 


Additionally, the example shows how to reset all options and revert the 


linus: svfo EXAMPLE-1.fo.lec -query;sfo -rs;-di -pg 1 


5 name job salary age s f st city 
e a at 
x mm e 

i 

1 

y 
abel 1 14555.01 36 m s ak juneau 
abell 2 13000. 01 55 f m az _ phoenix 
abernathy 3 12500. 01 61 m d ea “fresno 
abodoura 5 12900.01 — 61 m m ca sacramento 
aboe 4 19201.01 41 f s ca los angeles 
abraham 6 15000. 01 25 f d ea san diego 
- (46 data lines) 

64 baker 1 12000. 10 71 +m s il springfield 
line 1 
Save the current values of format options as a linus subsystem exec_com 
(EXAMPLE-1.fo.lec) which can be restored. later with the 
restore format_options request. Then reset all options to their default 
values, and display page 1. 
line 5-64 


System display -- note that the report has reverted back to its original 
format (i.e., it is now the same as the first example in this sample user 
session). 


At this point you may wish to terminate the linus session by entering: 


65 
66 


8/86 


linus: q 
(Multics ready message) 
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RESTORING A SAVED REPORT 


The report saved in the previous example may be recalled at will. Assuming you 
Want to have the report printed, then the following sequence of events must be set up: 


1 ! linus 
2 ! linus: o employer r 
3 ! linus: ss employee r u 
4 ! linus: rsfo EXAMPLE-1.fo.lec 
5 ! linus: di -nr -pg 1 
9 04/29/83 Sample Report 10: 26 
NAME | JOB { SALARY i AGE {| SEX | F | STATE } CITY 
: i H i At H 
i “al i i Mj i 
i H 1 i oe i 
1 i i i iL j i 
i i i i i Y¥ } i 
abel H 1 | $14,555.01 | 36 {| male i S it ak i juneau 
abell i 2 | $13,000.01 } 55 | female {| m { az i phoenix 
a<MORE> | 3 | $12,500.01 } 61 {| male i dj ea i fresno 
a<MORE> {| 5 + $12,900.01 } 61 {| male ; mj ea i sacramento 
aboe 4 + $10,201.01 | 41 | female | Ss { ca i los angeles 
(43 data lines) 
azer { 5 | $12,600.01 } 44 | male i s | va | norfork 
69 - Page 1 - 


71 ! linus: di -of example-1 


line 1-4 
Set up for restoring the saved format options. 


line 5 
Display page i of the report as a verification (i.e., is this the desired 
report?). 


line 9-69 
System display -- note that the report is restored to its original condition 
(i.e., restored to the same format as that shown in the example under "Special 
Editing of a Report" above). 


line 71 
Write the complete formatted report to permanent storage in the user's 
working directory with pathname of “example-1". 


The full report (example-1), along with the saved format options segment 
(EXAMPLE-1.fo.lec) now resides in the user's working directory and may be printed or 
retained in permanent storage at the user's discretion. 
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General Column Options 


The following examples look at the "general column options." These options 
remain in effect only for the duration of the current query. Every time a new 
query is performed, new default values are assigned. The options are listed 
(through use of the list _format_options request) when their value is different 
from the default, or when asked for by name. 


! linus: I1sfo -co 
-column order "name job salary age sex family state city" 


1 
2 
4 ! linus: sfo -co 8 712 34 5 6;di -pg 1 
8 


04/29/83 Sample Report 10:28 
| CITY | STATE {| NAME ; JOB | SALARY | AGE j; SEX i F 
i i i i i A 
H H i i i i i M 
i i i i i I 
i i i i L 
i H i i i i 1 ¥ 
juneau | ak i abel H 1 | $14,555.01 | 36 | male is 
phoenix i az i} abell i 2 1 $13,000.01 ; 55 ; female {| m 
fresno ; ca | a<MORE> ; 3 | $712,500.01 | 61 { male i qd 
- (45 data lines) 
norfork i va | azer H 5 | $12,600.01 | 44 | male is 
67 - Page 1 - 
line 1 
List the current names and order of the report columns. 
line 4 
Reorder the sequence of report columns and display page 1. 
line 8-67 
System display -- note that the column order has been changed from that 


displayed in the previous example. 


Even though the columns are re-ordered (line 4 above), the user must still set 
and list them in the query order sequence. For example: 


69 ! linus: sfo -wid 8 -default;isfo -wid 8 
-width city m3" 


Although city appears on the page first (i.e., left column in above example), 
the column is still column 8. 


71 ! linus: sfo -co 7 8;lsfo -co 
T2 -column_order "State city name job salary age sex family" 


Notice that all columns were not named in the -column_order request above (line 
71) and that the system defaults all names (line 72). Future displays of the 
report will have the columns reordered to 7 8 1 2 3 4 5 6 until changed by the 
user. 


4-36 AZ49-03 


74 ! linus: Ilsfo -ex 
75 -exclude fen 


77 ! linus: sfo -ex age job;di -pg 1 


81 04/29/83 Sample Report 10: 31 
STATE: CITY 1 NAME H SALARY | SEX | F 
! H 1 A 
i i M 
1 i | I 
i H i 1 ae? 
{ i i i i Y¥ 
ak ; juneau ; abel t $14,555.01 }| male 3s 
az } phoenix |} abell | $13,000.01 | female ; m 
ca | fresno ; a<MORED | $12,500.01 ; male i d 
- (45 data lines) 
va + norfork ; azer i $12,600.01 | male is 
140 - Page 1 - 
line 74 
List columns currently excluded from the report. 
line 75 
System display -- the response is "", meaning that no columns are currently 
excluded. 
line 77 


Exclude the age and job columns and display page 1. 


line 81-140 
System display -- note that the age and job columns have been excluded 
from the report (i.e., the report now consists of six columns of data 
instead of the eight previously included). 


142 ! linus: sfo -ex "";lsfo -ex 
143 -exclude wi 


Execution of line 142 restores the age and job columns previously excluded by 
execution of line 77. Line 143 is the system display indicating that no columns 
are currently excluded. 
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The next few examples look at the "group" option which is used in conjunction 
of rows based on 


with other requests. 


the content of one or more columns. 


145 ! 
146 


148 ! 
149 


15.14 


155 


201 


214 


linus: 
-group 


linus: 


-outline 


linus: 


isfo -gr 


sfo -gr state city sex;lsfo -out 


sfo -out sex;di -sort state city sex -pg 1,2 


04/29/83 © 


STATE | 


ak 


(16 data lines) 


az : 
] 
i] 
1 
i} 


ca 


; (6 data lines) 


——_ ae ee 


“LT Y 


juneau 


phoenix 


- (12 data lines) 


tucson 


fresno 


ttt 


tf 


This option is used to define a 


Sample Report 


NAME 


bambry 
gaskins 
justin 


abell 
c<MORE> 
june 


monaco 
nevitte 
pauley 
n<MORE> 


ordeman- 


bane 


a<MORE> 
c<MORE> 
jupiter 


4 


JOB 


10 
6 
H 2 


NM 
ine) 


Ww 


-38 


SALARY 


$11,501. 
$14, 700. 
$12,000. 


$13, 000. 
$18, 300. 
$10, 900. 


$12, 300. 
$12, 300. 
$11, 600. 
$12, 400. 
$15, 200. 
$15, 200. 


$12,500. 
$12, 400. 
$ 4,100. 


01 
01 
01 


01 
01 
01 


01 
01 
01 
01 
01 
01 


01 
01 
01 


"group" 


AGE 


AZ4H9-03 


10: 33 

SEX oe 

i A 

1 M 

a 

aa 

emp 4 

female | d 
i s 

; m 

female | m 
| 

| s 

female | d 
; s 

i; m 

male 1 m 
i d 

female {| m 
male i d 
i 8s 

i m 


This ends the first page of the report (refer to line 151 that set up a two-page 


display). 


The second page of the report immediately fOLTOWS the commentary 


describing the setup for page 1... 


line 145 

List the columns currently set for grouping purposes. 
line 146 

System display -- no current grouping set. 
line 148 


Set grouping for columns (state, city, and sex), and list the columns 
currently set as candidates for duplicate suppression. 


line 149 


line 151 


System display -- no current outline set. 


Set the outline column value to "sex." The outline option is used to 
Suppress duplicate columns. Outlining is done when the value of a column 
is the same for the current row as it is on the previous row. Outlining 
is never done when it is the first row of a new page. The example sets 
outlining for the sex column. The sex column is the most minor column 
in the group and therefore all columns more major have outlining done 
also. The second request on the line invokes display (with sort) of 
pages 1 and 2. First the data has to be sorted so that use of this 
option can be further described in later examples. 


The Pol owine example is page 2 of the REPO ys: invoked by the second request on 


line 151. 

04/29/83 Sample Report 10: 33 

STATE } CITY | NAME {| JOB {| SALARY | AGE {| SEX {F 
H i i A 
i H i H i M 
H H ; I 
1 1 H 4 i L 
i H i Y¥ 

ca | fresno ; leeland |} 14 | $32,800.01 ; 77 | male 1 d 
H } m<MORED $ 9 ; $10,200.01 } 32 | ; s 
H } meclung }| 5 4, $1355°1005.07 | iy ; m 
H t m<MORED j 1 + $14,100.01 {> 26 |} ; d 
H ; monger } 21 + -$12,600.01 } 61 } | s 
! los angeles } aboe H H } $10,201.01 } 41 | female } s 

- (37 data lines) 
| san diego ;} abraham } 6 | $15,000.01 } 25 | female j} d 
H ;} @<MORE> | 2 + $13,000.01 | Hy} is 
| kang 22 | $19,201.01 | 231 ; m 
H | levy ' 18 | $10,800.01 } 66 | 1 d 
H ; m<MORE>D } 13 | $14,800.01 | 71 | i s 
H } mecrary j 8 | $13,000.01 |} 25 | | m 

- Page 2 - 
4-39 AZ49-03 


Sorting is done external to MRDS. The values must all be retrieved before 
sorting can be done. When display is invoked without control arguments, the 
System defaults to a new retrieve on each invocation. The next two examples 
Show how this retrieve can be kept and then recalled. 


216 ! linus: di -sort state city sex -kr -pg 2 


220 04/29/83 Sample Report 10: 34 
STATE } CIETY 1 NAME ; JOB |} SALARY | AGE j SEX i F 
1 i i A 
i H H i M 
i 1 1 i bod 
H H i aL 
1 H Ho 4 
ca i fresno ; leeland | 14 | $32,800.01 } 77 | male ad 
H ; m<MORE> | 9 + $10,200.01 ; 32 | i s 
H i meclung } 5 | $13,100.01 } 71 | ; m 
H } mM<MORE> | 1 1 $14,100.01 | 26 } i d 
H } monger | 21 | $12,600.01 | 61 | a) 
234 | los angeles ; aboe H 4 + $10,201.01 } 41 | female {| s 
(37 data lines) 
; san diego i; abraham | 6 | $15,000.01 | 25 | female ; d 
H | @<MORE> } 2 + $13,000.01 |} yy | i s 
: | kang : 22 | $19,201.01 } 23 1 i ™m 
H i levy H 18 | $10,800.01 | 66 | i d 
| m<MORE> } 13 { $14,800.01: | 71 4 i s 
H | mecrary } 8 | $13,000.01 } 25 | 1 m 
279 - Page 2 - 
line 216 


Sort the state, city, and sex columns; then display page 2. In addition, 
keep the results of the retrieve. 


line 220 - 279 
System display. 


The sorted data is now retained for future use (see -kr on line 216). Future 
display requests may now re-call the kept data (i.e., the amount of system time 
required after execution of line 216 until the report is displayed can be minimized 
in future displays). 


281 ! linus: di -kr -or -pg 2 


The display results (provided by execution of line 281) would be an exact copy 
of that provided in line 220-279 above, except that the time required to produce 
the report is less. 


4-40 AZ49-03 


Outlining can also be done on columns which are not a member of the group. 


example: 
283 ! 
286 ! 
288 ! 
292 


338 


linus: 


-outline 


linus: 
linus: 


04/29/83 


STATE 


ak 


- (16 data lines) 


az I 
i] 
t 
i 
| 


(12 data lines) 


ca 


(6 


lsfo -out 


"Se 


sfo -out sex family 
di -kr -or -pg 1,2 


CITY 


juneau 


phoenix 


tucson 


fresno 


data lines) 


x" 


Sample Report 


NAME 


bambry 
gaskins 
justin 


abell 
ec<MORE> 
june 


monaco 
nevitte 
pauley 
n<MORE> 
ordeman 
bane 


a<MORE> 


a MADE 
c< MORE> 


jupiter 


JOB 


ae) 
NM 


wm 


SALARY 


$11,501.01 
$14,700.01 
$12,000.01 


$13, 000.01 
$10,900.01 


$12, 300.01 
$12, 300.01 
$11, 600.01 
$12, 400. 01 
$15,200.01 
$15, 200.01 


AGE 


ee ee ee ee —— aw ee 


For 


10: 36 
SEX Lr. 
© A 
1 M 
i I 
ae 
ae 
female ;} d 
i s 
; m 
female | m 
1 d 
; Ss 
female ; d 
is 
i m 

male H 
ae | 
female {| m 
male i d 
toe 
1. 
i m 


line 283 
List the columns currently set as candidates for duplicate suppression. 


line 286 
Set the outline column value to "sex" and "family." 
description regarding outlining in the commentary of line 151 above.) 


line 288 
Display page 1 and 2 using the data retrieved during the previous invocation 


line 292-351 


(-or), 


Subsequent invocations of the display request. 


(Refer to additional 


and keep the retrieved data (-kr) from this execution for use in 


System display -- note the family entry for line 338 is blank indicating 


duplicate suppression of 


line 201 above). 


im" 


Page 2 of the report is not shown. 


which would normally have displayed (see 


AZ49-03 


This page intentionally left blank. 


The size of aretrieved table can cause a process directory quota overflow when working 
with large tables. The-temp dir control argument for the display request allows the 
user to provide a directory for the retrieved table where enough quota is available. 
The -temp_dir argument can only be used when requesting a new table. 


353 ! linus: di -or -kr -td [e wd] -pg 1 
354 linus (display): Warning: The temp_dir >udd>Demo>linus_test won't be used. 


line 353 
Display page 1 using the data retrieved during the previous invocation (-or) 
and keep the retrieved data (-kr) from Phas. execution, utilizing the 
temporary directory "wd". 


line 354 
System display -- warning message because a newretrieval was not requested 
(i.e., -old retrieval was used). 


Page 1 of the report is not shown. It would be an exact duplicate of that shown in line 
292-351 above, if it were included here. 


356 ! linus: di -kr -td Le wd] -pg 1 -sort state city sex 


line 356 
Display page 1 using a newretrieval, keep the retrieved data for future use, 
and utilize "wd" for a temporary directory. 


Page 1 of the report is not shown. It would be an exact duplicate of that shown in line 
292-351 above, if it were included here. 


eu eee e see we eerae ewer ees eae weet eB eZee BZ eO eZ ew FZ eO@eeweZ ee eZee ee ew eS ew ww we ew & oe we oe we ee 8 Oe we ow we 98 8 os 


To verify that the working directory (wd) was in fact used for the temporary directory, 
enter: 


358 ! linus: ..1s 

Se Segments = 224, Length = 353 

360 

361 rew 0 !BBBJNHFGnQJX1Iw.temp. 0565 


369 rw 0 !BBBJNHFGmXFcFB.LINUS. table 
370 row 1 EXAMPLE-1.fo.lec 
371 rw 1 sex_lookup.lec 


line 358 
Escape out of linus and list the current contents of the working directory. 


line 359-371 
System display -- lines 359-369 outlines the areas used for the temporary 
directory. Note that line 370 is associated with an earlier example where the 
contents of a report was saved (refer to "Saving a Report and Resetting 
Options") and line 371 identifies the segment which contains the exec_com 
used to change "m" and "f" to "male" and "female" for the sex column (refer to 
"Special Editing of a Report"). 
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375 ! linus: 1lsfo -pb 
376 -page break 


nr 


378 ! linus: sfo -pb state;di -kr -or -pg 1,4 


Line 375 is a request to list the current columns that are candidates for new 
page breaks and line 376 says there are no current candidates. The following 
four examples show full-page representations of the results of the requests in 


line 378 (set page break value to "state" and display pages 1 through 4). 


yyy AZ49-03 


10: 39 


Sample Report 


04/29/83 


In et EH LH 


CITY 


TDNAFUVUNH EVHENAEVTAHVMNAAD DN 


1) 
cs 
oO 
= 


female 


WORK DMNKERKRKTOAEKMAKAAMM 
OM AMOKAMMMA AINE AAO 


i 
| 
1 
1 
4 
1 
1 
i 
i} 
i} 
{ 
i 
1 
i} 
t 
i} 
( 
i 
' 
t 
t 
i} 
‘ 
{ 
' 
( 
{ 
i 
t 
' 
i 
i 
! 
i 
i 
i 
i] 
I 


ee re Se ee 
ooooo9tT°0o°o°o°0°dc°o 90000 O00 

e e e e e es e e ° ° e ° ° e ° ° 
“TO O9TD009000MNN9D90000000 
oo°o0o00o0c00o0o 0ONnN0 00000000 
WOM OM QNOK NMR ODM HK EMM 
KaseNtWDWostsrMODsaNneannNsno 
b eee eel peel see see el ee ee were Neem Oo 
PPA A OF 0 FF 9 FF 0 AHH HO 


i 
| 
' 
4 
i] 
1 
' 
t 
' 
i} 
( 
{ 
' 
' 
) 
' 
' 
‘ 
] 
! 
4 
i] 
iJ 
t 
{ 
1 
' 
i 
i) 
' 
i] 
1 
' 
i 
i] 
i) 
! 
' 


9) Tw ANN WY OA ad 
~o so OnWbkic & 6. fx) ~>S 
hed YD Oe weed ono 3m or 
AMYDH BOOK aM OMHODTARNRA 
SBnnNVGFZAHDVDVOLGDPVA On Peds 
TTB SDUVGVVYDKANOWVWHAVYVOWAA 
MOMWNnNEFRB BE SK OMONMHBEBRB ES a 


juneau 


2 eee ee ee ee we ww ee ee ee we ee ee ee ew ow ow em em 


ak 
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Sample Report 


04/29/83 


fu eg EH Ld) 


CITY 


ETNEUVHNHN ENHEVTN EVH DONE ne] 


oe ee ee ee ee ee ee ee ee ee ee ee ee Oe 


w 0) 

Coma} re 

iY) wo a) co) 
£ qo =] a 
wv 3) 3) is) 
CH £ G4 = 
WOM ONO K DAATMNOOh,WO 
LAM P= Bh MO LD NLD ME OLN OM LO LO 
CS OT ES TS Oe OS SS eS ee 
OT70 00000000 000000009000 
*. © @e@ @ @ @ @ @ @ @ @ e e e 6° e e e ° 
oeooocnco0o000°0nda°oe°o°oo°coeo o0o0o0 
ooooqc0o0o°0c0o°ocoo0ooco°0o00o0°0o0°00 
OMNDWO DA OMNIA NNO MMO =a A 
MOOWNANOKRRKTANNTRK ONAN AIA 
re Sr See Ne <—-— Qe errr - — 


PAAAAAAAAGAHAHAAAEA HH HOH HH 
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Now we will experiment with column subtotals and totals. A subtotal specification 
is given in the form of one or more "triplets." A triplet is given as the 
column to be subtotaled, followed by the column whose value change should generate 
the subtotal, and optionally followed by "reset" or "running" to indicate what 
type of subtotal is desired. Reset is the default. In the following example, 
line numbers 1-8 are intentionally left blank. 


9 ! linus: sfo -rhv "™ -orfy ™ 
11 ! linus: Ilsfo -stt 
12 -subtotal wit 


14°! linus: sfo -stt salary,state,reset 


The subtotal inherits its width, editing request, ete. from the parent column. 
The width of the salary column must be increased or the subtotal will be folded, 
and a larger picture is needed to edit it through. The age and job columns are 
left at their present width so the filling of numbers can be seen later when the 
numbers become large enough. 


16 ! linus: I1sfo -wid salary 
17 -width salary 1p" 


19 ! linus: sfo -wid salary 14 
21 ! linus: 1sfo -ed salary 
22 -editing salary "~Tpic $zz,zz9v.99 [clv salary]]" 


24 ! linus: sfo -ed salary "[piec $zz,zzz,zz9v.99 [clv salary]]" 
26 ! linus: Ilsfo -al salary 
27 -alignment salary "decimal 8" 


29 ! linus: sfo -al salary decimal 12 
31 ! linus: di -nr -kr -sort state city sex -pg 1,4 


35 04/29/83 Sample Report 10: 42 
STATE | CITY | NAME JOB SALARY | AGE | SEX ae 

H H i A 

H i i M 

i i ie! 

H H i L 

i Y¥ 

ak { juneau f bambry } 10 i $ 11,501.01 | 66 } female } d 

i | gaskins | G6 1 °-s 14,700.01 | 31 ] i $s 

i | justin | Bt tg 12,000.01 | 78 | i m 


- (15 rows of data) 


paul 9: $ 10, 300.01 13 


64 ak 


Seg 


262,056. 19 


- (30 blank lines) 
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line 9 


Set row header and row footer values to "default." 


line 11-14 


List current value for subtotal, 


line 16-29 


and set up new value. 


List current value for width, editing, and alignment of the salary column, 


and set up new values. 


line 31 


Display pages 1 through 4 of the report, starting with a new retrieval, 
sorting the report as indicated to get back into the full format, and 


keep the retrieval for re-use. 


line 35-281 


System 


(total by state 


display 


see line 64, 


pages of the report follow. 


127, 


and 276). 


-- note the inclusion of subtotals in the salary column 
The remaining three 


97 04/29/83 
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127 az 


(31 blank lines) 


15 


CITY 


phoenix 


(13 rows of data) 
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ec<MORE> 
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pauley 

n<MORE> 
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JOB 


133) 


- Page 


4-51 


13,000.01 
18, 300.01 


AA 


$ 12, 300.01 
$ 12, 300.01 
$ 11,600.01 
$ 12,400.01 
$ 15,200.01 


$ 272, 700. 19 


me ee ee ee ree 


5D 
38 
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10, 201.0 
9,500.0 
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(17 rows of data) 
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sacramento 


(12 rows of data) 
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(16 rows of data) 
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(17 rows of data) 
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(4 blank lines) 
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The following example shows how to get subtotals for multiple columns in addition to more 
than one subtotal per column. 


I EW i) = 


~ 
a= 


! linus: 


linus: 


11 04/29/83 


sfo -stt -prompt 
Enter -subtotal. 
! age,sex salary,sex job,sex age,city salary,city job,city 
! salary,state job,state 


di -or -kr -pg 1,3 


Sample Report 
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STATE | CITY i NAME 
. i] i] 
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i i 
‘ i] 
i} { 
i i 
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i } justin 
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H i m<MORE> 
H i m<MORE> 
i i nesline 
i i ord 
{ i] 
! 1 
| 30 
i i abel 
i i cooke 
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i i ledger 
i i; maclure 
i {| m<MORE> 
H | mead 
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H i nevling 
i i paul 
i] i] 
' 4 
43 ak ; juneau i 
| 
} 46 ak | juneau 
i] i] 
t ( 
} 49 ak 
- (22 blank lines) 
71 
line 1 
Request to set columns for subtotaling, 
line 2 
System display -- prompt. 
line 3-5 
Set column values to be subtotaled, and 
8/86 
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SALARY 


11,501.01 
14,700.01 
12,000.01 
18,500.01 
10, 000.01 
14,900.01 
13, 000.01 
10,100.01 
9, 200.01 


113,901.09 


14,555.01 
12, 100.01 
13,000.01 
21,900.01 
14,700.01 
12,100.01 
12,700.01 
4, 300.01 
32,500.01 
10, 300.01 


262,056.19 


with prompt. 


age,state 


AGE 


terminate the prompt. 
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Display pages 1 through 3. 


line 7 


System display -- the display of pages 2-3 follow. 


line 11-195 


10:43 
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To see how the totals feature works, the last page of the report must be examined. 
The example eliminates page breaks to cut down on the number of pages generated. 


197 ! linus: sfo -tt age salary job 
199 ! linus: sfo -pb ™" 


Just as retrieved data can be re-used, so can formatted reports. The last few 
pages will be examined, but display will be asked to keep the formatted report. 
It will use the previously established temp dir to place the copy of the formatted 
report. 
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Now that the report appears correct, it can be written (saved) toafile. -old_ report 
will be specified so that display uses the previously formatted report. 


203 ! linus: di -orp -of SAMPLE REPORT -kr 


The complete report (SAMPLE REPORT) now resides in the user's working directory and 
ean be dprinted atwill. The-keep retrieval control argument was specified in order 
to continue this session, but could have been eliminated if the user was terminating 
the session after saving this report. 
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Now we will experiment with generation of a report utilizing the group footer/header 
and left/right trim operations. 


1 ! linus: sfo -rs 
3 ! linus: sfo -pw 60 -tl off -pb state 
5 ! linus: sfo -ex 12345 67 8 -gr state city 
7 ! linus: sfo -gft city -ght city 
9 ! linus: sfo -gfv -prompt -ghv -prompt 
10 Enter -group footer value. 
11 f ree! = ~ 
j2!. 
13 Enter -group header value. 
14 9 !City: [elv city]!!T 
15 ' gee! 
162%. 
18 ! linus: sfo -phv -prompt -pfv -prompt 
19 Enter -page header value. 
20 ! !State: [elv state]!!! 
21: ries 
22 !. 
23 Enter -page footer_value. 
oe 
25 ! !!- Page [dib page number] -!! 
26! . 
28 ! linus: sfo -rhv -prompt 
29 Enter -row header value. 
30 ! Employee [rtrim [clv name]] is [ltrim [clv age]] years old and earns 
[pic $z9,999v.99 [clv salary]]!!! 
31! . 
33 ! linus: di -or -kr -sort state city salary -pg 1,3 
37 State: ak 
39 City: juneau 
40 Employee molloy is 22 years old and earns $ 4,300.01 
Employee ord is 34 years old and earns $ 9,200.01 
Employee manuel is 33 years old and earns $10,000.01 
Employee nesline is 27 years old and earns $10, 100.01 
Employee paul is 73 years old and earns $10, 300.01 
Employee bambry is 66 years old and earns $11,501.01 
Employee justin is 78 years old and earns $12,000.01 
Employee cooke is 34 years old and earns $12,100.01 
Employee meclenehan is 71 years old and earns $12, 100.01 
Employee mead is 29 years old and earns $12,700.01 
Employee jones is 21 years old and earns $13,000.01 
Employee meadoows is 77 years old and earns $13,000.01 
Employee abel is 36 years old and earns $14,555.01 
Employee gaskins is 31 years old and earns $14,700.01 
Employee maclure is 53 years old and earns $14,700.01 
Employee mccormick is 67 years old and earns $14,900.01 
Employee macleod is 43 years old and earns $18,500.01 
Employee ledger is 27 years old and earns $21,900.01 
Employee nevling is 63 years old and earns $32,500.01 
. (37 blank lines) 
97 - Page 1 - 
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line 1-5 
Resets all options (i.e., restore the report back to its original format), 
set page width to 60, turn title line "off," set the page break to 
"State," exclude all 8 columns of the report, and group the report by 
"state" and "city." 


line 7 
Sets the group footer/header trigger to "city." 


line 9-16 
Sets the group footer value to a blank line (!!!!) and the group header 
value to "City:" (left-justified). 


line 18-26 
Sets the page header value to "State:" (left-justified), the page footer 
(2 lines) to contain a blank line (!!!!), and the second footer line to 
"_ Page X —", 


line 28-31 
Sets the row header value to read (left-justified and trimmed): 


Employee X is X years old and earns $X 


line 33 
Invokes display, using the sort sequence "State city salary." 


line 37 - 225 
System display -- notice that the top of each page (lines 37, 101, 165) 
indicate a report by state (ak, az, ca). Additionally, the report is 
sorted by city, where: 


ak - juneau (line 39) 

az - phoenix (line 103) 
- tucson (line 121) 

ca - fresno (line 167) 
~ los angeles (line 185) 
- Sacramento (line 207) 


and finally employees are listed in ascending salary order. 


The remaining two pages of the report follow. 
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103 


State: 


az 


City: phoenix 


Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 


manzo is 74 years old and earns $ 4,200.01 
meadow is 52 years old and earns $ 9, 800.01 
meagher is 52 years old and earns $10,500.01 
meclowsky is 68 years old and earns $10, 800.01 
june is 73 years old and earns $10,900.01 
dupuis is 28 years old and earns $12,000.00 
Kane is 58 years old and earns $12, 300.01 
maclin is 79 years old and earns $12,500.01 
macmahon is 37 years old and earns $12, 600.01 
abell is 55 years old and earns $13,000.01 
geist is 21 years old and earns $14,600.01 
lednar is 71 years old and earns $15,000.01 
coreoran is 38 years old and earns $18, 300.01 
bander is 70 years old and earns $21, 100.01 
mecoy is 67 years old and earns $31, 300.01 


City: tucson 


Employee 
Employee 
Employee 
Employee 
Employee 


pauley is 56 years old and earns $11,600.01 
monaco is 30 years old and earns $12, 300.01 
nevitte is 77 years old and earns $12, 300.01 
neubauer is 57 years old and earns $12,400.01 
ordeman is 21 years old and earns $15,200.01 


(33 blank lines) 
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165 
167 


185 


207 


225 


State: ca 


City: fresno 


Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 


jupiter is 47 years old and earns $ 4,100.01 
maclure is 47 years old and earns $ 9,700.01 
kang is 76 years old and earns $10,000.01 
macmannis is 32 years old and earns $10,200.01 
meakin is 51 years old and earns $11,600.01 
george is 44 years old and earns $12,100.01 
eostello is 53 years old and earns $12,400.01 
abernathy is 61 years old and earns $12,500.01 
mecrary is 53 years old and earns $12,500.01 
marcey is 71 years old and earns $12,600.01 
monger is 61 years old and earns $12,600.01 
meclung is 71 years old and earns $13,100.01 
meadoows is 26 years old and earns $14, 100.01 
bane is 50 years old and earns $15,200.01 
leeland is 77 years old and earns $32, 800.01 


City: los angeles 


Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 


Emp] ovee 


ov 


ecowes is 58 years old and earns $ 9,500.01 
newhall is 30 years old and earns $10,000.01 
aboe is 41 years old and earns $10,201.01 
giannoti is 45 years old and earns $10,900.01 
macmillan is 52 years old and earns $11,400.01 
leestma is 69 years old and earns $12, 300.01 
katz is 70 years old and earns $12,400.01 

orf is 70 years old and earns $12,400.01 
marcus is 62 years old and earns $12,600.01 
meagher is 67 years old and earns $12,600.01 
mecory is 54 years old and earns $12,700.01 
justin is 34 years old and earns $12,900.01 
pavlov is 24 years old and earns $14,000.01 
macmahon is 57 years old and earns $14, 800.01 
nevitte is 39 years old and earns $14,900.01 
mecormick is 26 years old and earns $15,000.01 
monroe is 42 years old and earns $18,900.01 
mealey is 36 years old and earns $21,600.01 


barker is 78 years old and earns $32, 800.01. 


Jwvwue we YI 37 Vvve 


City: sacramento 


Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 
Employee 


newman is 68 years old and earns $ 4,200.01 
orlaens is 41 years old and earns $10, 300.01 
mecullough is 62 years old and earns $10,900.01 
gill is 47 years old and earns $11, 800.01 
macmannis is 54 years old and earns $12,200.01 
neweomb is 36 years old and earns $12, 300.01 
kane is 24 years old and earns $12,400.01 
barrett is 65 years old and earns $12, 800.01 
abodoura is 61 years old and earns $12,900.01 
leonard is 25 years old and earns $12,900.01 
meakin is 71 years old and earns $12,900.01 
monson is 40 years old and earns $13,000.01 
mecoy is 77 years old and earns $14,000.01 
keene is 54 years old and earns $14, 100.01 
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229 ! linus: q 
230 (Multics command level - ready message) 


This coneludes the sample user sesSion. 
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SECTION 5 
COMMAND DESCRIPTION 
This section contains a description of the linus command and its associated 
requests. Each request description contains the name (including the abbreviated 


form, if any), discusses its purpose, and shows correct usage. Notes and examples are 
included where necessary for clarity. 
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linus 


Name: 


linus 


linus 


This command invokes linus to access an MRDS data base. It provides both 


retrieval and update operations. Data to be selected is specified via query 
statements. 


Usage 


Note: The linus command (pre-MR10.2 version) is described in Section 6. 


linus {-control_args} 


where control_args can be chosen from the following: 


8/86 


-abbrev, -ab 
enables abbreviation expansion and editing of request lines. 


-iteration, -it | 
recognizes parentheses in the request line to indicate request line 
iteration. 


-no_abbrev, -nab 
disables abbreviation expansion and editing of request lines. (Default) 


~no_iteration, -nit 
interprets parentheses in the request line literally (i.e., no iteration 
of request line). (Default) 


“no prompt, -npmt 
turns off prompting er athinas: This control argument can be overridden 
later (see set_mode request). (Default is prompt) 


-no_start_up, -nsu 
specifies that the subsystem start _up exec _com is not to be executed. 


-profile path, -pf path 
specifies the pathname of the profile used for abbreviation expansion. A 
profile suffix must be the last component to path; however, the suffix 
need not be supplied in the command line. This control argument implies 
-abbrev. 


-prompt STR 
sets the prompting string used bylinus to STR. If STR contains embedded 
blanks, it must be enclosed in quotes. (Default linus prompt is 
"linus:".) 


-request STR, -rq STR . 
executes STR as a Linus request line before entering the request loop. 
This control argument cannot be used with the macro_path argument 
described in Section 6, and the requests Specified by STR cannot contain 
the invoke request, aiso described in Section &. 


-Start_up, ~-Su 
specifies that the subsystem start _up exec com "start_up.lec" is 
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linus linus 


executed prior to entering the request loop. The start_up is searched 
for in the user's home directory, project directory, and then >site. 
(Default) 


Notes 


By default, linus prompts the user whenever input is expected (the string 
"linus:" is displayed at linus request level). Refer to the description of the 
set_mode request for information on how to turn off prompting. 


Multiecs program_interrupt conditions are recognized and handled by linus. 
Thus, the user may interrupt any request and resume the linus session by invoking the 
Multics program_interrupt command. After the program interrupt command, linus waits 
for the user to type further requests. 


There is no data base creation facility within linus. Those users who wish to 
ereate their own data base should refer to Section 3 for information on the creation of 
an MRDS data base. 


8/86 5-3 AZ49-03A 


linus linus 


LINUS Requests 


The following list summarizes all of the linus requests. 


identifies the linus subsystem, version number, and open data- base. 


“lists the available linus requests. 


abbrev, ab 
turns abbreviation processing ON or OFF and changes profile segments. 


answer 
Supplies an answer to a question. 


apply, ap 
places the current query in a temporary file, adds the file name to the 
supplied command line, and executes the Multics command line. 


assign_values, av 
specifies that selected data is to be retrieved and that retrieved values 
are to be assigned to the designated variables. 


close, ¢ 
closes the currently open data base. 


column value, clv 
returns the value of the specified column for the current row, previous 
row, or next row, 


create list, cls 
Specifies that selected data is to be retrieved and written to a Lister 
file to create a formatted report. 


declare, del 
allows the user to declare user-written functions for later invocation 
within the selection expression. 


define temp table, dtt 
specifies that selected data is to form a new temporary table, known only 
to the process, but which can be accessed by the process for retrieval in 
the same manner as data base tables. 


del_scope, ds 
deletes all or a portion of the current scope of access in a shared data 
base. 


delete, dl 
specifies that selected data is to be deleted from the data base. 


delete temp table, ditt 
deletes the specified temporary table. 


display, di 
retrieves selected data, creates a report, and displays the information 
or writes it to a file. 


display builtins, dib- 
returns the current values for requested built-ins. 
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linus 


do 
substitutes args into the request line and passes the result to the teeUe 


request processor. 


exec com, ec 
executes the linus exec_com indicated byec path. The ec_ path arguments 
are passed to the exec com processor. 


execute, e 
executes a Multics command line after evaluating linus active requests. 


format_line, fl 
“returns a single, quoted character string, formatted from an ioa_ control 


string. 

help 
displays information about request names or topics. Alist of available 
topics is produced by the list_help request. 

if 


conditionally executes a request. 


input query, iq 
allows the entering of a query for data manipulation requests. 


invoke, i (an OBSOLETE request moved to Section 6) 
lila (an OBSOLETE request moved to Section 6) 
list_db, 1ldb 
lists specified information about the currently open data base. 
list _format_options, lsfo 


lists the names and values of format options. 


list_help, lh 
lists the available info segments whose names include a topic string. 


list_requests, Ir 
lists information about linus requests. 


list_scope, ls 
lists the scope of access currently in force. 


list_values,lv 
lists the current value assigned to the designated linus variables. 


ltrim 

returns a character string trimmed of specified characters on the left. 
modify, m 

specifies that a selected portion of the data base is to be modified. 
open, o 


opens a specified data base, with either a data model or data submodel 
view, for linus processing. 


opened database, odb 


returns "true" if there is an open data base and "false" if there is no 
open data base. 
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picture, pic 
returns one or more values processed through a specified PL/I picture. 


print, pr 
specifies that selected data is to be retrieved and displayed on the 
terminal in default format. 


print query, pq 
displays the current query. 


qedx, qx 
invokes the gqedx editor with the current or a new query. 


quit, q 
terminates a linus session. 


report, rpt 
specifies that selected data is to be retrieved and used to create a 
formatted report via the Multics Report Program Generator (MRPG). 


restore _format_options, rsfo 
restores saved report layouts. 


rtrim 
returns a character string trimmed of specified characters on theright. 


save format_options, svfo 
Saves current values of format options for future use. 


Save query, sq 
Saves the current query. 


set_format_ options, sfo 
changes/sets report format options. 


set_mode, sm 
sets or resets modes for the current session. 


set scope, ss 
defines the current scope of access within a shared data base (this, 
together with del_ scope, provides concurrent usage control). 


store, s 
adds new rows to specified tables in the data base. 


store from_data file, sdf 
takes newrows froma file and adds them to the specified table in the data 
base. 


string 
returns a single character string formed by concatenating all of the 
Strings together, separated by single spaces. 


subsystem_name 
displays the name of the subsystem, "linus". 


subsystem_version 
displays the current version of linus. 


translate query, tq 


translates the current query, making it available for data manipulation 
requests. 
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write, w 
specifies that selected data is to be retrieved and written toa filein 


the storage system. in the storage system. 


write data file, wdf 
retrieves selected data and writes it to a file in a format suitable for 
input to the store from_data file request. 


The remainder of this section contains a detailed description of each request, 
including standard subsystem environmental requests (i.e., requests common to other 
subsystems such as abbrev, answer, do, etc). All examples show the prompting string 
"linus:" prior to lines of user input. 
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Usage 


Reque 


Usage 


Sst: . 


This request identifies the linus subsystem, version number, and open data base. 


st: ? 


This request displays the available linus requests. 


Example 


the 1 
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The following list is displayed when "?" 


inus prompt. 
linus: ? 
linus: 


cs 

abbrev, ab 
answer 
apply, ap 


assign values, av 
close, c 
eolumn_value, clv 
create list, cls 
declare, del 


define temp table, dtt 


delete scope, ds 

delete, dl 

delete temp table, 
ditt 

display, di 

display builtins, dib 

do 

exec com, ec 

execute, e 

format_line, fl 


Available linus requests: 


help, h 
if 


input_query, iq 

invoke, i 

lila 

list_db, ldb 

list_help, lh 

list format options, 
lsfo 

list_requests, lr 

list_scope, ls 

list_values, lv 

ltrim 

modify, m 

open, o 

opened database 

picture, pic 

print, pr 

print_query, pq 

gedx, qx 

quit, q 


is entered by the user in response to 


report, rpt 


restore format options, 


rsfo 

rtrim 

save_format_options, 
svfo 

save query, sq 

set_format options, 
sfo 

set_mode, sm 

set scope, ss 

store, s 

store from_data_file, 
sdf 

string 

subsystem_name 

subsystem_version 

translate query, tq 

write, w 

write date file, wdf 


Type "list_requests" for a short description of the requests. 
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abbrev abbrev 


Request: abbrev, ab 


This request controls abbreviation processing within the subsystem. As an 
active request, it returns "true" if abbreviation expansion of request lines is 
currently enabled within the subsystem and "false" otherwise. , 


Usage 


ab {-control_args} 


Usage as an Active Request 


[ab] 


wnere control args can be chosen from the following (and cannot be used with the active 
request): 


-off 
specifies that abbreviations are not to be expanded. 


-on 
specifies that abbreviations should be expanded. (Default) 


-profile path 
specifies that the segment named by path is to be used as the profile 
segment; the profile suffix is added to pathif not present. The segment 
named by path must exist. 


Notes 


This subsystem provides command line control arguments (-abbrev, -no_abbrev, 
-profile) to specify the initial state of abbreviation processing within the 
subsystem. For example, a Multics abbreviation can be defined to invoke the read_mail 
subsystem with a default profile as follows: 


-ab rdm do "read_mail -abbrev -profile [hd]>mail_system &rfi" 


If invoked with no arguments, this request enables abbreviation processing 
within the subsystem using the profile that was last used in this subsystem 
invocation. If abbreviation processing was not previously enabled, the profile in 
use at Multiecs command level is used; this profile is normally 
Chome dir]>Person_id.profile. 


See the abbrev command in the Multics Commands for a description of abbreviation 
processing. 
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Request: answer 


This request provides preset answers to questions asked by another request. 


Usage 


answer STR f{-control args} request line 


is the desired answer to any question. If the answer is more than one 
word, it must be enclosed in quotes. If STR is -query, the question is 
passed on to the user. The -query control argument is the only one that 
can be used in place of STR. 


2. request_line 
is any subsystem request line. It can contain any number of separate 
arguments (i.e., have spaces within it) and need not be enclosed in 
quotes. 


3. control args 
ean be chosen from the following: 


suppresses display (on user terminal) of both the question and the 
answer. 


-call STR 

evaluates the active string STR to obtain the next answer in a sequence. 
The active string is constructed from subsystem active requests and 
Multics active strings (using the subsystem "execute" active request). 
The outermost level of brackets must be omitted (i.e., "forum_list 
-changed") and the entire string must be enclosed in quotes if it contains 
request processor special characters. The return value "true" is 
translated to "yes," and "false" to "no." All other return values are 
passed as is. 


-exclude STR, -ex STR 
passes on, to the user or other handler, questions whose text matches STR. 
If STR is surrounded by slashes (/), it is interpreted as a qedx regular 
expression. Otherwise, answer tests whether STR is literally contained 
in the text ofthe question. Multiple occurrences of -match and -exclude 
are allowed (see "Notes" below). They apply to the entire request line. 


-match STR 
answers only questions whose text matches STR. If STR is surrounded by 
Slashes (/), it is interpreted as a qedx regular expression. Otherwise, 
answer tests whether STR is literally contained in the text of the 
question. Multiple occurrences of -match and -exclude are allowed (see 
"Notes" below). They apply to the entire request line. 


“query 


skips the next answer in a sequence, passing the question on to the user. 
The answer is read from the user_i/o I/O switch. 


8/86 5-10 AZ49-03A 


answer . apply 


-then STR 
supplies the next answer in a sequence. 


-times N 
gives the previous answer (STR, -then STR, or -query) N times only (where 
N is an integer). 


Notes 


The answer request provides preset responses to questions by establishing an ON 
unit for the condition command _question and then executes the designated request 
line. If any request in the request line calls the command query subroutine 
(described in the Multics Subroutines) to ask a question, the ON unit is invoked to 
supply the answer. The ON unit is reverted when the answer request returns to 
subsystem request level. See "List of System Conditions and Default Handlers" in the 
REF Manual for a discussion of the command question condition. 


If a question is asked that requires a yes or no answer, and the preset answer is 
neither "yes" or "no," the ON unit is not invoked. 


The last answer specified is issued as many times as necessary, unless followed 
by the -times N control argument. 


The -match and -exclude control arguments are applied in the order specified. 
Each -match causes a given question to be answered if it matches STR; each -exclude 
causes it to be passed on if it matches STR. A question excluded by the -exclude 
eontrol argument is reconsidered if it matches a -match later in the request line. For 
example, the request line: 


answer yes -match /fortran/ -exclude /fortran_io/ -match /*fortran io/ 


answers questions containing the string "fortran", except that it does not answer 
questions containing “"fortran_io". It does, however, answer questions beginning 
with "fortran_io". 


Request: apply, ap 


This request places the current query into a temporary file, adds the pathname of 
the file to the end of the supplied command line, and executes the resulting Multics 
command line. If there is no current query, or the -new control argument is used, the 
ereated file is initially empty. 


Usage 


ap {-control_args} command_line 
where: 
1. eontrol_ args 


ean be chosen from the following: 
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apply assign values 


-new 
specifies that an empty file be initially created. 


-old 
specifies that the existing query be made available. (Default) 


2. command line 
is a Multies command line request. 


Example 


apply -new ted -pn 


apply emacs 


Request: assign values, av 


This request specifies that selected data is to be retrieved and the retrieved 
values assigned to designated linus variables. This capability allows information 
obtained from one retrieval to be used in subsequent data base accesses. Atranslated 
or translatable query must be available. As an active request, it returns "true" if 
data is successfully retrieved and "false" if the select statement fails. 


Usage 


av variable list 


Usage as an Active Request 


[av variable list] 


where variable list is a list of one or more variable names. 


Notes 


A variable name is an alphanumeric character string, from 1 to 32 characters in 
length, which must begin with an exclamation mark (!). The underscore (_) and hyphen 
(-) may also be included, but the exclamation mark cannot appear elsewhere in the name. 
The specification in an assign values request is the only declaration required. If 
the same variable is specified in several assign values requests, its value is 
reassigned in each of those requests. Variable names and values are preserved across 
data base openings and closings within the same linus session. 


Variables specified in the assign values request are unrelated to row 
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assign values assign values 


Retrieved data is assigned to variables in the variable list in the order 
retrieved. Retrieval ceases when all selected data is exhausted or when all variables 
in the variable list are exhausted, whichever occurs first. In the case of the 
retrieved data being exhausted before the variable list, the following occurs: 
previously assigned variables that occur ina variable list but are not assigned new 
values by this assign value request retain their previous value. Newvariables in the 
variable list that are not assigned values are not created. 


Variable names are global within a linus session (i.e., like variable names 
occurring in different linus exec coms refer to the same variable) if the exec_coms 
are used in the same linus session. 


Example 


List the employees whose total compensation is above the department store 
average, and then list those employees who are below the average. 


linus: input query -force 
Query: 
avg {select sal + comm from emp} 


linus: assign values !av_comp 
linus: input_query -force 
Query: 

select name sal + comm 

from emp 

where sal + comm > favg comp 


linus: print 


name fCemp) 
Smith, John 10000 
Jones, Al 12000 
Johnson, Betty 11900 
(END) 

linus: qedx 

3s/>/</ 

1,$ p 

select name sal + comm 
from emp 

where sal + comm < !avg comp 
write 

quit 


linus: print 


name fCemp) 
Anderson, Caroli 8066 
(END) 
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close column value 


Request: close, c 


This request closes the currently open data base. 


Usage 


fe) 


Request: column value, clv 


This request returns the value of the specified column for the current row, 
previous row, or nextrow. It can only be used as an active request. It is used within 
a formatted report produced by the display request to obtain the value of acolumn. It 
is an error to use this request anywhere except in a header/footer or editing string 
within a report produced by the display request. 


| Usage as an Active Request 


[elv column_id {-control_args}] 


where: 


1. column_id 
specifies which column value is to be returned. It can be given as the 
name of the column as defined in the open model/submodel, or the number of 
the column in the query. 


2. control args 
can be chosen from the following: 


-current_row, -crw 
returns the value of the named column for the current row. (Default) 


-default STR 
returns the character string STR when there is no previous row, or when 
there is no next row. (If this control argument is not used the default 
value for STR is "".) 


~next row, -nrw 
returns the value of the named column for the next row. If there is no 
next row, the string "" is returned unless changed by the -default control 
argument. 


-previous_row, -prw 


returns the value of the named column for the previous row. If thereis no 
previous row, the string "" is returned unless changed by the 
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column value 


Examples 


create list 


C[eolumn_ value foo] 


Leolumn_ value 3] 


[eolumn_value foo -previous_row] 


[eolumn_ value foo -next_row -default NULL] 


Request: create_list, cls 


Usage 


where 


1. 


2s 


8/86 


This request specifies that selected data is to be retrieved and written to a 
specified Lister file. This file can be manipulated via Lister commands to create a 
formatted report. Atranslated or translatable query must be available. Refer to the 
WORDPRO Manual for a complete description of Lister. 


els path {-control_ args} 


path 


is the pathname of a Multics file into which the selected data is to be 
written. The datais written ina form suitable for processing by Lister. 
The suffix lister is appended to the pathname (if not present in the 
invocation) and the file is created if it does not exist. If the file 
currently exists, it is truncated unless the -extend control argument is 


specified. 


control args 


can be chosen from the following: 


-extend 


Specifies that if the Lister file already exists, it is to be added to 
rather than truncated. The field names (either default or explicitly 
specified) must be identical to those defined in the existing file. 


-field_ names STR, -fn STR 


NOTE: 


explicitly specifies the field names in the Lister file being created or 
extended. STR is a list of field names that must correspond in order and 
quantity to the items specified in the select clause of the associated 
query. This control argument must be specified if the query select 
clause contains an expression. If not specified, the names of the 
selected data base columns become the lister file field names. 


The values being written to the lister file have all leading and trailing 
blanks stripped off. 
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create list declare 


Examples 


A query to create a Lister file containing the names and salaries for all 
employees in the Shoe department is: 


linus: input query -force 
Query: . 

select name sal 

from emp 

where dept = "Shoe" 


Arequest to create the Lister file "shoe _sal.lister" with the field names "name" 
and "sal" is: 

linus: create list snoe_sal 

The same file could be created with the field names "name" and "Salary" with the 
request: 


linus: create list shoe sal -field_names name salary 


Request: declare, del 


This request allows the user to declare a nonstandard function which may be 
invoked in a subsequent query. A nonstandard function is any function not included in 
built-in functions listed in Section 2, and may be user-written or may be provided by 
the local installation. Twotypes of functions may be declared: set functions which 
operate on multiple sets of values (for example, sum {...}) and scalar functions which 
operate on one occurrence of a set of values. 


Usage 


del fn_name fn_type 
where: 


Tyg fn name 
~ is the name of the function being declared. The fn_name must be the name 
of an object segment that can be found using the searchrules currently in 
effect. 


2. fn_type 
is the type of the function being declared. Two types are permitted, set 
or scalar. A set-type-function operates on multiple sets of selected 
values, whereas a scalar-type-function operates on one set of specified 
values. An example of a set function is: 


avg {select salary 
from emp} 


while a scalar function example would be: 


substr (name 1, 5) 
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declare — define temp table 


Notes 


Sealar functions can accept column values as input from one table only, provided 
no row designators are used. If row designators are specified, column names must all 
be qualified with the same row designator. 


Several built-in functions are provided as a standard part of linus. See Section 
2 for a description of these functions. It is not necessary to declare built-in 
funetions. If a declared function has the same name as a built-in function, the 
declared function, rather than the built-in function, is invoked when the function 
name is referenced. 


Example 


To find the average sales volume of all items made of cotton in a specific 
department, several assumptions are made: 1) that the item code contains encoded 
information indicating the material of which an item is made, 2) that the user-defined 
scalar function "material" returns this information, and 3) that there is a 
user-defined set function "dept _avg" that calculates the desired average, which is 
the total volume divided by the number of departments. 


linus: declare material scalar 
linus: declare dept_avg set 


These functions may now be used in a query as: 


linus: input_query -force 

Query: 

dept_avg {select dept vol 
from sales 


whara materia 17 { 
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Request: define temp table, dtt 


This request causes selected data to be placed into a temporary table that can 
then be referenced as any other table in the data base for retrieval purposes. This 
feature is useful from an efficiency standpoint, since multiple retrievals of the same 
data can be avoided. A translated or translatable query must be available. 


Usage 


dtt table name key columns 


where: 


1. table name 
is the name of the temporary table. Subsequent references to this table 
must use this name. If a temporary table of this name already exists, it 
is redefined. This name may be from 1 to 32 characters long, must begin 
with an alphabetical character, and may be composed of alphanumeric 
characters plus the underscore (_) and the hyphen (-). 
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define temp table define temp table 


2. key columns 
are one or more column names specified in the associated select clause 
that become key columns in the temporary table. Key columns uniquely 
determine the rows of the temporary table; that is, the concatenation of 
the values of all key columns must be unique for each rowof the temporary 
table. Duplicates are automatically eliminated. 


Notes 


The select clause of a query associated with a define temp table request cannot 
contain an expression. Only column names (qualified or unqualified, including *) are 
allowed. 


All key columns must be explicitly specified in the associated select clause; 
that is, a key column cannot be one of those specified bya*. Theorder of the columns 
in the key of the temporary table is the order in which they appear in the select 
clause, not the order in the define temp table request. 


Temporary tables cannot be updated, but can be accessed for retrieval only. 
Temporary tables that do not have any tuples may be created. Normally, a temporary 
table is created for the purpose of simplifying queries when data is to be selected 
from several tables in the data base. 


Examples 


If it is necessary to retrieve employee information from the department store 
data base depending upon the floor on which the employers are located, then a temporary 
table could be useful. 


emp_loc (name, emp_no, mgr, sal, comm, floor) 
The data for such a temporary table couid be specified using the following query: 


linus: input_query -force 

Query: 

select emp.name emp.emp no emp.mgr emp.sal 
emp.comm loc.floor 

from emp loc 

wnere emp.dept = loc.dept 


The table is then created with the request: 
linus: define temp table emp_loc name 


The query necessary to find the average salary of all employees located on the second 
floor would be: 


linus: input _query -force 
Query: 
avg {select sal 

from emp_loc 

where floor = 2} 


as opposed to the following, if the temporary table were not available: 
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define temp table del_scope 


linus: input query -force 
Query: 
avg {select sal 
from emp 
where dept = {select dept 
from loc 
where floor = 2}} 


Request: del scope, ds 


This request deletes all or a portion of the scope of access previously declared 
with a set_scope request, and is applicable only for shared (nonexclusive) opening 
modes. As an active request, it returns "true" if the scope is deleted and "false" if 
the delete scope fails. 


Usage 


ds table namel {permit_ops1 prevent_ops1 ... table _namen permit_opsn 
prevent _opsn} 


Usage as an Active Request 


[ds table-namel {permit_ops1 prevent_ops1 ... table_namen 
permit _opsn prevent_opsn}] 


where: 


1. table namei 
is the name of a nontemporary table within the date base for which allora 
portion of the scope of access is to be deleted. If table namelisa *, 
then no additional arguments need be specified, and all of the user' 5 
current access scope is deleted, even if none is set. 


2. permit opsi 
is a character string indicating which currently permitted operations 
are to be deleted from the access scope. 


3. prevent _opsi 
is a character string indicating which of the operations currently being 
prevented for other processes can be deleted from the access scope. 


Note 
The null operation is ignored for delete scope. 


See the set_scope request for a definition of the operation codes and for a 
detailed discussion of the scope mechanism. 
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del_ scope delete 


Examples 


Do not change permission for the employee table but allow other processes to 
perform store, modify, and delete operations. 


linus: del scope emp n smd 
Delete all of the current scope of access. 


linus: del_scope * 


Request: delete, dl 


This request deletes selected rows from a single table within the data base. The 
data base must be open for update or exclusive update and, if open for update, the 
affected table must be within the scope of access for delete. A translated or 
translatable query must be available. 


Usage 


dl 


The select clause of the associated query must specify columns from only one 
table and all columns from that table must be specified (use of * is recommended). The 
query must not contain any set operators (union, inter, or differ). The affected 
table cannot be a temporary table. 


Example 


Joe Smith has retired. Delete his employee record. The query would be: 


Linus: input query 
Query: 

select * 

from emp 

where name = "Joe Smith" 


The deletion is then accomplished via the request: 


linus: delete 
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delete temp table 


Request: delete temp table, dltt 


Usage 


display 


This request is used to delete temporary relations created for the current data 
base opening by the define temp table request. 


ditt temp table name 


where temp table name is a table name which has successfully been used in a 


define temp table request since the last successful open request. 


Request: display, di 


terminal or sends it toa fileor an io switch. 


be av 


Usage 


8/86 


This request retrieves selected data, creates a report, and displays it on the 


ailable. 


di {-controli_args} 


A translated or translatable query must 


The following list identifies all control arguments grouped by 
funetion. The argument descriptions are listed alphabetically, 


immediately after the function groupings. 


CONTROLLING WARNING MESSAGES 
-brief, -bf 
-long, -lg 


DISPLAYING PAGES AND PORTIONS OF PAGES 


-all, -a 
-character_positions, -chpsn 
“page, -pg 


DATA RETRIEVAL INITIATION AND TERMINATION 
-diseard_retrieval, -dsr 
-keep retrieval, -kr 
~new retrieval, -nr 
-old_retrieval, -or 


REPORT INITIATION AND TERMINATION 
-discard report, -dsrp 
-keep report, -krp 
-new_report, -nrp 
-old_ report, -orp 
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display | display 
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SORTING RETRIEVED DATA 
-sort 


CONTROLLING REPORT OUTPUT 
-extend 
-output file, -of 
-output_switch, -osw 
-truncate, -te 


VIDEO SYSTEM SCROLLING FUNCTIONS 


-enable escape _ keys, -eek 
-enable function_keys, -efk 
-seroll 


-set_key, -sk 
-window, -win 


MULTI-PASS REPORT FORMATTING 
-passes, -pass 


TEMPORARY STORAGE SPECIFICATION 
-temp dir, -td 


-all, -a 
displays all pages of the report. This argument is incompatible with the 
-pages control argument. (Default) 


-brief, -bf 
suppresses warning messages. 


-character_positions STR1 {STR2}, -chpsn STR1 {STR2} 
where STR1 and STR2 define the left and right character positions of a 
vertical section of the report. STR1 must be given and defines the left 
margin position to begin from. STR2 is optional, and if not given, 
defaults to the rightmost character position of the report. If this 
control argument is not given, the entire page is displayed. 


-discard report, -dsrp 
deletes the report on termination. (Default) 


-~discard_ retrieval, -dsr 
deletes retrieved data on termination. (Default) 


-enable_ escape keys, -eek 

specifies the use of escape key sequences for scrolling functions, rather 
than the function keys and arrow keys on the terminal. This is the 
default if the -scroll control argument is given and the terminal does not 
have the necessary set of function keys and arrow keys (see 
~enable function keys). (In the following description, the mnemonic 
"esc-" means the escape key on the terminal.) The following escape key 
sequences are used if this control argument is given, or the terminal 
lacks the necessary set of keys: 


Function Name Key Sequence 
forward esc-f 
backward esc-b 
left esc-] 
right ese-r 
help esc-? 
set_key esce-k 
set_scroll_ increment esc-i 
quit Ssouag 
redisplay esc-d 
start_of_report esc-S 
end_of_report esc-e 
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display © . display 


multics mode esc-m 
goto esc-g 


-enable function keys, -efk 

specifies the use of terminal function keys and arrow keys for scrolling 
functions. This is the default when the -scroll control argument is 
given and the terminal has at least nine function keys and four arrow 
keys. (In the following description, the mnemonic fNmeans function key 
N, where Nis the number of the function key. The mnemonic down arrow 
means the down arrow key, up_arrow means the up arrow key, left_ arrow 
means the left arrowkey, and right_ arrow means the right arrow key. The 

following key sequences are used if this control argument is given and the 

' terminal has the necessary set of keys: 


Function Name Key Sequence 
forward down_arrow 
backward up_arrow 
left left_arrow 
right right_arrow 
help | f1 (function key) 
set_key f2 
set_scroll_ increment £3 

quit £4 

redisplay £5 
start_of_report £6 

end of report f7 

multics mode £8 

goto £9 


-ex tend 
appends the report to an existing file rather than replacing it if the 
-output_file control argument is used. (If this control argument is not 
provided, the default is to truncate an existing file.) 


eep report, -krp 
keeps the report on termination. This control argument is necessary in 
order to use -old_ report on subsequent invocations of display. 


-keep retrieval, -kr 
keeps retrieved data to allow re-use on subsequent invocations of the 
display request. Previously retrieved sorted data retains the sort 
order. 


-long, -1g 
displays warning messages when a control argument such as -old_ retrieval 
is used and the data from a previous retrieval is not available. 
(Default) 


-new_report, -nrp 
creates a new report. (Default) 


-new_retrieval, -nr 
begins a new retrieval from the data base. (Default) 


-old_ report, -orp 
uses the report created in the previous invocation. Use of this control 
argument requires that -keep report be used in the prior invocation of 
display. . 


-old_retrieval, -or 
uses data retrieved during the previous invocation. Useof this control 
argument requires that -keep retrieval be used in the prior invocation of 
display. 
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display . display 


-output_file path, -of path 
where path is the name of the file which contains the formatted report. 
If this control argument or -output_ switch is not given, the report is 
displayed on the terminal. This argument is incompatible with the 
-~output_switch control argument. 


-output_ switch switch_name, -osw switch _name 
where switch_name is the name of a switch to be used to display the report. 
If this control argument or -output_file is not given, the report is 
displayed on the terminal. It is an error touse this control argument if 
the named switch is. not already open and attached when display is invoked. 
This argument is incompatible with the -output_file control argument. 


-page STR, -pg STR 

~pages STR, -pgs STR 
where STRis a blank-separated list of pages (NN) or comma-separated page 
ranges (N,N). Page ranges can also be given as N, or "N,$" which means 
from page Nto the end of the report, or simply $which means the last page. 
This argument is incompatible with the -all control argument. 


-passes N, -pass N 
where Nis the number of times the report is to be formatted. No output is 
produced until the last formatting pass of the report. (Default value 
for Nis 1) 


-secroll 
specifies scrolling the report according to key sequences read from the 
terminal. Only terminals supported by the Multics video system can use 
the scrolling feature. If the -window control argument is not used, 
create a uniquely named window for the display of the report. The 
user_i/o window is reduced to four lines and the remaining lines are used 
for the uniquely named report display window. The minimum size for this 
window is five lines, so the user_i/o window must be at least nine lines 
before invoking display, unless the -window control argument is used. 


-set_key STR, -sk STR 

-set_keys STR -sks STR i 
specifies that the named scrolling functions are to be set to the provided 
key sequences. STR is a blank-separated list of one or more scrolling 
function names and key sequences, given as "function name key sequence 
... {function_name key _sequence}". The function names can be chosen 
from the set described under -enable escape keys or 
-enable function keys control arguments. The key sequences can be given 
as the actual sequences or mnemonic key sequences. The provided 
mnemonics can be: 


fN where N is the number of the desired 
function key 


esc=- or escape- corresponds to the escape character 
etl-x or control-x corresponds to the character sequence 


generated when the control key is held 
while also pressing the character named by 


Wy " 
down_arrow corresponds to the down arrow key 
up_arrow corresponds to the up arrow key 
left_arrow corresponds to the left arrow key 
right arrow corresponds to the right arrow key 
home corresponds to the home key 
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display 


-sort STRs {-ascending i -descending} {-case sensitive | 


display builtins 


-non_case_ sensitive}, -sort STRs f-ase {| -dsc} {-es i -ncs} 


where STRs are the names of columns as defined in the open model/submodel, 
or numbers corresponding to the position of the columns in the selection 
expression. It can be followed by -ascending or -descending, and 
-case_ sensitive or -non_case_ sensitive. (Default is -ascending and 
-case sensitive.) 


-temp dir dir_name, -td dir_name 


specifies that the given directory be used for storing the retrieved 
data, saving the report if -keep report is used, and sorting workspace if 
-sort is used instead of the process directory. This temporary directory 
continues to be used until another new temporary directory is requested. 
A new temporary directory can only be specified when a newretrieval and 
new report are requested. 


-truncate, -tc 


replaces the contents of the existing file if the -output_ file control 
argument is used. (If the -extend control argument is not provided, the 
default is to truncate.) 


-window STR, -win STR 


Examples 


specifies that the window named by STR be used for the display of the 
report. This argument is only meaningful when the -scroll argument is 
also used. If this control argument is used, the window named by STR must 
be attached and open under the video system, and it must be at least five 
lines high. 


display 


display 
display 
display 
display 
display 


display 


-output_file foo 

-keep retrieval -sort bar -descending -non_case sensitive 

-keep retrieval -keep report -of fool -character positions 1 132 
-old_retrieval -old_ report -of foo2 -character_positions 133 260 
-pages i 3 12,19 58,$ -output switch foo 


-sort foo -descending bar -non_case_ sensitive 


Request: display builtins, dib 


This request returns the current value of the built-in named by STR. It can only 
be used as an active request. It is used within a formatted report produced by the 
display request to obtain the current value of the specified built-in. It is anerror 
to use this request anywhere except in a header/footer or editing string within a 
report produced by the display request. 


Usage as an Active Request 


Cdib STR] 
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display builtins 


where STR can be any one of the following built-ins: 


current _pass_ number 


the number of the current pass. The number begins with 


do 


1 and is 


incremented by 1 for each additional formatting pass over the report. 


current row_number 
the number of the current row of the report. 


Saat mA UT 
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not the first row of the report. 


last_page_ number 


Erue if the current row is the first row of the report, or falseif it is 


“the number of the last page of the report: or "O" if it is the first pass 
over the report. After each formatting pass, the number is updated with 


the number of the last page. 


last_pass 


“true if this is the last formatting pass of the reports or false if this is 


not the last pass of the report. 


last_row 


true if the current row is the last row of the report, or false if the 


current row is not the last row of the report. 


last_row_number 


“the number of the last rowof the table, or "O"if it is the first pass over 
the report. After the first formatting pass the number is set to the 


number of the last row. 


page number 
the number of the current page of the report. 


previously processed_ row 


true if the current row was processed on the preceding page but the row 
value would not fit and had to be déferred to the current page, or falseif 


this is the first time the current row is being processed. 


Request: do 


This request expands a request line by substituting the supplied arguments into 
the line before execution. As an active request, it returns the expanded 


request string rather than executing it. 


Usage 


do request_string {args} 


ors: 


do -control_args 
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Usage as an Active Request: 


[do "request_string" args] 


wnere: 


1. request_string 
is a request line in quotes. 


24 args. 
are character string arguments that replace parameters in 
request_string. 


3. eontrol_ args 
can be chosen from the following to set the mode of operation: 


-absentee 
establishes an any other handler that catches all conditions and aborts 
execution of the request line without aborting the process. 


-brief, -bf 
specifies that the expanded request line not be printed before execution. 
(Default) 
specifies that the expanded request line be passed on for execution. 
(Default) - 
~interactive a Hale A : 
: specifies that the any_other handler not be established. (Default) 
-long, -lg = i 


J ' ' 
displays’ the expanded request line before execution. 


-nogo 
specifies that the expanded request line not be passed on for execution. 


List of Parameters 


Any sequence beginning with & in the request line is expanded by the do request 
using the arguments given on the request line. 


&I 
is replaced by argI. I must be a digit from 1 to 9. 
&(I) 
is replaced by argI. I may be any value. 
&qI 
is replaced by argI with any quotes in argI doubled. I must bea digit from 1 
to 9. 
&q(I) 


is replaced by argI with any quotes in argI doubled. I may be any value. 
&ri 


is replaced by argI surrounded by level quotes with any contained quotes 
doubled. I must be a digit from 1 to 9. 
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do 


exec com 
&r(1) 
is replaced by a requoted argI. I may be any value. 
&fI 
is replaced by all the arguments starting witharglI. Imust bea digit from 
1 to 9 
&f(1L) 


is replaced by all the arguments starting with argI. I may be any value. 


&qfi . 
is replaced by all the arguments starting with argI with any quotes doubled. 
‘IT must be a digit from 1 to 9. 


&qf (1) 
is replaced by all the arguments starting with argI with quotes doubled. I 
_ may be any value. , 


&ri 
is replaced by all the arguments starting with argI. Each argument is 
placed in level quotes with contained quotes doubled. I must be a digit 
from 1 to 9. 


&rf(1) 
is replaced by all the arguments starting with argI, requoted. I maybe any 
value. 


&& 
is replaced by an ampersand. 


is replaced by a 15-character unique string. The string used is the samein 
every place where the &! appears in the request line. 

&n 
is replaced by the actual number of arguments supplied. 


&f&n . 
is replaced by the last argument supplied. 


Request: exec_com, ec 


This request executes a program written in the exec com language that is used to 
pass request lines to linus and to pass input lines to requests that readinput. As an 
active request, it specifies a return value by use of the &return statement. 


Usage 


ec ec_ path {ec_args} 


Usage as an 


{2 
re 
5 
GQ 
Cc 
- 
< 
a 
a 
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[ec ec path fec_args}] 
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exec com execute 


where: 

1. ec path 
is the pathname of an exec _com program. An lec suffix is assumed if not 
specified. 

2. ec args 


are optional arguments to the exec_com program and are substituted for 
parameter references in the program such as &1. 


Notes 


For a description of the exec _com language (both Version 1 and Version 2), type: 


-» help viee v2ec 


When evaluating a linus exec _com program, linus active requests are used rather 
than Multics active functions to evaluate the &[...] construct and the active string 
in an &if statement. The execute active request of linus can be used to evaluate 
Multiecs active strings within the exec com. Refer to Section 7 for a description of | 
how to write a linus exec_com. 


Request: execute, e 


This request executes the supplied line as a Multics command line. As an active 
request, it evaluates a Multics active string and returns the result to the subsystem 
request processor. 


Usage 


e STR 


Usage as an Active Request 


fe STR] 


where STRis the Multics command line to be executed or the Multics active string 
to be evaluated. It need not be enclosed in quotes. 


Notes 


The recommended method to execute a Multics command line from within a subsystem 
is the ".." escape sequence. The execute request is intended as a means of passing 
information from the subsystem to the Multics command processor. 
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All (), €], and "s in the given line are processed by the subsystem request 
processor and not the Multics command processor. This permits passing values of 
subsystem active requests to Multics commands when using the execute request, or 
passing values to Multics active functions for further manipulation before returning 
the values to the subsystem request processor for use within a request line. 


Examples 


The linus request line: 
[execute max [column_value salary] [column_value commission] ] 


eould be used as an editing request within a formatted report to return the largest 
value of the salary and commission columns. 


The linus request line: 


set_format_ options -page header_value 
Texecute copy_characters - [list _format_options -page width]] 


could be used to set the page header to a line of hyphens whichis the same width as the 
page width. 


Request: format_line, fl 


This request returns a single, quoted character string that is formatted from an 
ioa_ control string and other optional arguments. 


Usage 


fl control_string {args} 


Usage as an Active Request 


(fl control_string {args}] 


where: 


13 control_ string 
is an ioa_ control string used to format the return value of the active 
function. See "Notes" below. 


2. args 
are character strings substituted in the formatted return value, 
according to the ioa_ control string. 
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Notes 


The following ioa_ control codes are allowed (refer to "ioa_"in the Subroutines 
Manual for additional detail): 


Control : Function 

“a “Na edit a character string in ASCII 

“d “Nd edit a fixed-point number 

“e “Ne edit a floating-point number in exponential form 
“f “Nf “N.Df *.DF edit a floating-point number 

ee TY, edit a fixed-point number (same as “d) 

*o “No edit a fixed-point number in octal 

“s “Ns skip argument 

a! start an if/then/else or case select group 
= limit the scope of a “[ 

ie ia Be start an iteration loop. 

*) end an iteration loop 

ve. hs used as a clause delimiter between “[ and 7] 


In addition, any of the following carriage movement controls can be used: 
“N/ “Ni “N= “Nx “N* *R “*B 
or 


! = x 
where Nis an integer count ora "v". When "v" is given, an integer character string 


from the args is used for count. (For a complete description of these control strings 
see "ioa_" in the Subroutines Manual.) 


If no optional arguments are given, the value returned depends on the specified 
ioa_ control string. 


Examples 


In a formatted report the editing request: 
[format_line "Height*-Weight*/*a*-“a" [column_value height] [column_value weight]] 
might be expanded to return the string: 
Height Weight 
6.1 175 


The report editing request: 


nan 


oe line "*“([Senior Citizen Discount 


? 
av Fanl: -~1 aaal & 
wl LCO.umn VaLue ages vu 


;Regular Discount*]" 
Co 4] 


would be expanded to return the string: 
Senior Citizen Discount 


if the value of the age column was greater than 60. 
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Request: help 


This request displays information about linus topies including detailed 
descriptions of linus requests. 


Usage 


help {topics} {-control_args} 


where: 


Ws topics 
specifies the topics on which information is to be displayed. The topics 
available within linus can be determined by using the list _help request. 


van control args 
ean be chosen from the following: 


-brief, -bf 
displays a summary of a request or active request, including the syntax, 
list of arguments, control arguments, etc. 


-search STRs, -srh STRs 
displays the paragraph containing all the strings identified by STRs. 
(Default, the display begins at the top of the information.) 


-section. STRs, -sen STRs 
displays the section whose title contains all the strings identified by 
STRs. (Default, the display begins at the top of the information.) 


-title 
displays section titles and section line counts, then asks if the user 
wants to see the first paragraph of information. 


The most useful responses that can be given to questions asked by the help request 
are: 
displays "help" to identify the current interactive environment. 


-» command line 
treats the remainder of the response as a Multics command line. 


9 

displays a list of responses allowed. 
no, n u 

stops display of information and proceeds to the next topic, if any. 
quit, q 


Stops display of information and returns to subsystem request level. 


rest {-section}, r {-scen} 
displays remaining information without intervening questions. If 
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help 


Notes 


if. 


-section is given, help displays the rest of the current section, without 
questions, and then asks if the user wants to see the next section. 


search {STRs} {-top}, srh {STRs} {-t} 


skips to the next paragraph containing all the strings identified by STRs. 
If -topis given, searching starts at the top of the information. If STRs 
are omitted, help uses the STRs from the previous search response, or the 
-search control argument. 


section {STRs} {-top}, sen {STRs} {-t} 


skips to the next section whose title contains all the strings identified by 


_STRs. If -top is given, title searching starts at the top of the 
information. If STRs are omitted, help uses the STRs from the previous 


section response, or the -section control argument. 


skip {-section}} {-seen}, s {-sen} {-seen} 


skips to the next paragraph. If -section is given, the request skips all 
paragraphs of the current section. If -seen is given, the request skips to 
the next paragraph that the user has not seen. Only one control argument is 
allowed in each skip response. 


title {-top} 


displays titles and line counts of the sections that follow. If -top is 
given, help displays all section titles and repeats the previous question 
after titles are displayed. 


yes, y 


prints the next paragraph of information on this topic. 


If no topic names are given, the help request explains what help requests are 


available in the subsystem. 


For a complete description of the control arguments and responses accepted by 
this request, type: 


help help 


Request: if 


This request conditionally executes one of two request lines depending on th 


value of an active string. As an active request, it returns one of two character 
strings to the subsystem request processor depending on the value of an active string. 


Usage 
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if expr -then linel {-else line2} 
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Usage as an Active Request 


{if expr -then STR1 {-else STR2}] 


where: 

le expr 
evaluates the active string as "true" or "false." The active string is 
eonstructed from subsystem active requests and Multics active strings 
(using the execute active request of the subsystem). 

2. linet 
executes the subsystem request line if expr is "true." If the request 
line contains any request processor characters, it must be enclosed in 
quotes. 

3: line2 
executes the subsystem request line if expr is "false." If omitted and 
expr is "false," no additional request line is executed. If the request 
line contains any request processor characters, it must be enclosed in 
quotes. 

4, STR1 
returns this value to the active request when expr is "true." 

5. STR2 


.returns this value to the if active request when expr is "false." If 
omitted and the expr is "false," a null string is returned. 


Request: input_query, iq 


This request collects a query and makes it available for linus data manipulation 
requests. 


Usage 


iq {-control_args} 


where control args can be chosen from the following: 
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-brief, -bf 
Specifies that the prompt "Query:" be suppressed when the query is 
entered from the terminal. 


-~force, -fce 
specifies that the existing query be replaced. If aquery exists and this 
control argument is not used, the user is asked if the existing query 
should be replaced. A negative response terminates the invocation of 
input_query. 


-input_ file path, -if path 


snecifies that the query be taken from the file named by path. If path 
does not contain the lquery suffix, it is assumed. 
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Example 


in 
in 
Qu 
se 


Refer t 


Request 


Th 


Informa 


-~long, -lg 
specifies that the prompt "Query:" be displayed when the query is input 
from the terminal. (Default) 


-no_ force, -nfe 
if a query exists, the user is asked if it should be replaced. (Default) A 
negative response terminates the invocation of input query. 


-terminal input, -ti 
specifies that the query be read from the terminal. (Default) A line 
consisting of only the single character "." terminates the input. 
Typing "\q" anywhere on a line also terminates the input. Typing "\f" 
anywhere ona line terminates the input and enters theuser directly into 
the qedx editor with the query. 


put_query -if query file -fe 


put_query 
ery: 
lect * from sales 


o Section 1 for examples of query statements. 


: list_db, ldb 


is request lists information about the data base that is currently open. 
tion which can be listed includes the pathname of the data base, the opening 


mode, table names, column names, and detailed information about each table and column. 


Informa 


Usage 


id 


where ec 
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tion for both temporary and permanent tables is provided. 


b {-control_ args} 
ontrol_args can be chosen from the following: 


-long, -lg 
Specifies that all available information about columns is to be listed. 
This includes the name of the domain from which column values are derived 
and the PL/I-like declaration for this domain. 


-names 
specifies that only table and column names are to be listed. 


-pathname, -pn 
specifies that only the pathname of the data base, together with the 
opening mode, is to be listed. 


-perm 


specifies that information pertaining only to tables that are a permanent 
part of the data base is to be listed. 
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~table names 
specifies that only table names are to be listed. 


-table STR, -tb STR 
specifies that information pertaining only to tables named in STR is to be 
listed. STR is a list of permanent or temporary table names. 

-temp 


specifies that information pertaining only to temporary tables is to be 
listed. ; 


Notes 


If no control arguments are specified, -pathname and -table names are assumed. 
If -table, -temp, or -perm is not specified, then information for all permanent and 
temporary tables is supplied. 


If -table is specified, all other controls except -long and -pathname are 
ignored. — 
Only one of the following may be chosen: 
~table names 
-names 
-long 
For non-DBA users of secure data bases (see the MRDS manual for the definitions of 
DBA and secured data bases), the following format changes will be seen because of 
possible security leaks: 
ike Domain names will not be displayed. 
2% Columns comprising the key of the table will not be shown as "key" columns. 


The first column in the key will be displayed as "index." All other columns 
will be shown as "data." 


Examples 


List the data base pathname and opening mode. 
linus: list db -pathname 
>udd>Demo>dbmt>db>dept_ store 
update 
List the names of all currently defined temporary tables. 
linus: list _db -temp -table names 


TABLE 


tempi 


& aan DO 
veuyva 
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Request: list_format_options, lsfo 


This request lists the names and values of individual report formatting options, 
all report formatting options, or the active report formatting options. As an active 
request, it returns the value of the single specified format option. 


Usage 


lsfo -control_arg 
or: 


lsfo -format_option_args 


Usage as an Active Request 
[Llsfo -format_option_arg] 


where: 


1. control _ args 
ean be chosen from the following: 


~active, -act 
Specifies that only the active formatting options are to be listed. 
(Default) "help formatting options.gi" is typed for more information on 
active formatting options. This control argument is incompatible with 
-all and the format option arguments. If -active and -all are both given, 
the last one supplied is used. 


-all, -a 
Specifies that all formatting options are to be listed. This control 
argument is incompatible with -active and the format option arguments. 
If -all and -active are both given, the last one supplied is used. 


2. format _option_args 
can be one or more of the following: 


Note: The following list identifies all format option 
arguments grouped by function. The argument 
descriptions are listed alphabetically, immediately 
after the function groupings. 


GENERAL REPORT OPTIONS 
-delimiter, -dm 
-format_document_controls, -fde 
-hyphenation, -hph 
-page footer_value, -pfv 
~page header_value, -phv 
-~page length, -pl 
-page width, -pw 
-title line, -tl 
-trunecation, -te 


8/86 5-37 AZ49-03A 


list_format_options . list_format_options 


8/86 


GENERAL COLUMN OPTIONS 
-column_ order, -co 
-count, -ct 
-exclude, -ex 
-group, -gr 
-group_ footer_trigger, -gft 
-group footer value, -gfv 
-group header trigger, -ght 
-group_header_ value, -ghv 
-outline, -out 
-page break, -pb 
-row_footer_value, -rfv 
-row_header_value, -rhv 
-subcount, -set 
-subtotal, -stt 
-total, -tt 


SPECIFIC COLUMN OPTIONS 
-alignment, -al 
-editing, -ed 
-folding, -fold 
-separator, -sep 
-title, -ttl 
-width, -wid 


-alignment column_id, -al column_id 
displays the “alignment mode within the display width for the specified 
eolumn. (Also see "Notes".) 


-column_order, -co 
displays the order of columns in the detail line. 


ccount, -ct 


displays the columns which have counts taken on them. 


~delimiter, -dm 
displays the character used to delimit the different portions of a header 
or footer. 


-editing column_id, -ed column_id 
displays the "editing string for the specified column. (Also see 
"Notes".) 


“exclude, -ex 
displays the columns to be excluded in the detail line. 


-folding column id, -fold column_id 
displays the folding action taken when the column value exceeds the 
display width for the specified column. (Also see "Notes".) 


-format document controls, -fde 
displays the interpretation of embedded format document controls when 
filling (on), or the treatment of embedded controls as ordinary text 
(off). 


-group, -gr 
displays the columns used to group a number of rows based on their values. 


-group footer_trigger, -gft 
displays the columns which can cause the generation of the group footer. 


-groun footer value, -gfv 


gee Re 


displays the group footer placed after each group of rows. 
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-group_ header_trigger, -ght 
displays the columns which can cause the generation of the group header. 


~group_ header value, -ghv 
displays the group header placed before each group of rows. 


-hyphenation, -hph 
displays hyphenation where possible for overlength values (on), or no 
hyphenation (off). 


-outline, -cut 
displays the columns which can duplicate suppression. 


-~page_break, -pb 
displays the columns which can cause a break to a new page. 


-~page footer_value, -pfv 
displays the page footer sinded at the bottom of each page. 


-page header_value, -phv 
displays the page header placed at the top of each page. 


-page length, -pl 
displays the length of each formatted page given as the number of lines. 


-page width, -pw 
displays the width of each formatted page given as the number of character 
positions. 


~row_ footer_value, -rfv 
“displays the row footer placed after each row value. 


-row_header_value, -rhv 
displays the row header placed before each row value. 


-separator column id, sep column id. 
displays the “character string that peparaces the specified column from 
the column in the detail line which immediately follows it. (Also see 
"Notes".) 


-subcount, -set 
displays the columns that have subcounts taken on them. 


-subtotal, -stt 
displays the columns that have subtotals taken on them. 


-title column_id, -ttl column_id 
displays the character string that is placed at the top of the page above 
the specified column. (Also see "Notes".) 


-title_ line, -tl 
displays printing of the title line (on) or the suppression of the title 
line (off). 


-total, -tt 
displays the columns that have totals taken on them. 


-truncation, -tc 
displays the character or characters used to indicate truncation. 


-width column_id, -wid column_id 


displays the display width in the detail line for the specified column. 
(Also see "Notes".) 
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Notes 


The variable column_id identifies the column name as defined in the open 
model/submodel, the number of the columnin the query, or a star name whichis matched 
against the column names. 


Refer to the description of the set_format options request for a complete list of 
the default values for the format options and a discussion of their allowed values. 
When used as an active request, only one format _option_arg can be specified. 


Examples 


list _format_options 
list_format_ options -all 
list_format_options -width 1 -alignment salary 


list_format_options -page width -title ** -page length 


Request: list_help, lh 


This request lists the names of all subsystem info segments pertaining toa given 
set of topics. 


Usage 


lh {topics} 


where topics specifies the topics of interest. Any subsystem info segment that 
contains one of these topics as a substring is listed. 


Notes 


If no topics are given, all info segments available for the subsystem are 
displayed. 


An info segment name is considered to match a topic only if that topic is at the 
beginning or end of a word within the segment name. Words in info segment names are 
bounded by the beginning and end of the segment name and by the characters period (.), 
hyphen (-), underscore (_), and dollar sign ($). The info suffix is not considered 
when matching topics. 
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Examples 


The request line: 
list_help list 


matches info segments named list values, list scope, list_db, etce., but would not 
match an info segment named prelisting, if such a segment existed. 


Request: list_requests, lr 


This request displays a brief description of selected subsystem requests. 


Usage 


lr {STRs} {-control_args} 


where: 


1. STRs 
specifies the requests to be displayed. Any request with a name 
containing one of these strings is displayed unless -exact is used, in 
which case the request name must match exactly one of these strings. 


2. control_args . 
can be chosen from the following: 


~all, -a 
includes undocumented and unimplemented requests in the display of 
requests eligible for matching the STR arguments. 


~-exact 
displays only those requests whose names match exactly one of the STR 
arguments. 


If no STRs are given, all requests are displayed. 


A request name is considered to match a STR only if that STRis at the beginning or 
end of a word within the request name. Words in request names are bounded by the 
beginning and end of the request name and by the characters period (.), hyphen (-), 
underscore (_), and dollar sign ($). 


Examples 


The request line: 


list_requests values 
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matches requests named list values and assign values, but does not match a request 
named column_value. 


Request: list_scope, 1s 


This request lists the current scope settings for permanent tables in the data 
base. As an active request, it returns the current scope settings. 


Usage 


ls {-control_arg} 


Usage as an Active Request 


[ls {-control _arg}] 
where control_arg can be -table name-1 {... namen}, or -tb name-1 {... namen} which 
specifies that scope settings for only the named tables are to be listed. If -tableis 


not specified, scope settings are listed for every permanent table in the data base 
that is in the current scope of access. 


Examples 


List the current scope of access. 


linus: list scope 


Table Permitted Prevented 
emp rm rsmd 
sales r n 


List the current scope of access for the sales and supply tables. 


linus: list_scope -table sales supply 


Table Permitted Prevented. 
sales r n 
supply n n 


Request: list_values, lv 


This request lists the values of the designated linus variables. For 
information on creating linus variables see the assign values request in this 
section. As an active request, it returns the value assigned to the designated linus 
variable. 
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Usage 


lv {variable 1... variablen} 


Usage as an Active Request 


[lv variable] 


ltrim 


where variablei is one or more linus variable names (each name must begin with an 


exclamation point (!)). If this argument is omitted, 


then all existing linus 


variables are assumed to be the designated variables, and their values are displayed 


in the order that they were assigned their first values. 
can be supplied when used as an active request. 


Example 


linus: list_values abe 


abe = 123 


Request: ltrim 


Only one linus variable name 


This request returns a character string trimmed of specified characters on the 


left. 


Usage 


ltrim STRa {STRb} 


Usage as an Active Request - 


C[ltrim STRa {STRb}] 


Notes 


The ltrim command or active function, finds the first character of STRa not in 
STRb, trims the characters from STRa preceding this character, and returns the trimmed 


result. Space characters are trimmed if STRb is omitted. 
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Examples 
string [ltrim 000305.000 0] 
305.000 
string [ltrim " This is it. ny 


This is it. 


Request: modify, n 


This request modifies selected data in the data base. The data base must be open 
for update or exclusive update. If open for update, the table being updated must be 
within the current access scope for the modify operation. New values may be specified 
within the request line, or they may be entered interactively, in response to linus 
prompting. In both cases, the user is asked to verify the new values before the 
modification takes place, unless the -brief control argument is specified. A 
translated or translatable query must be available. 


Usage 


m {column_values} {-control_arg} 


where: 


1. column values 
are optional arguments and, if present, specify the new values that are to 
replace the current values of the data selected by the associated query. 
The column values must be specified in the same order that the associated 
column names are listed in the select clause. If not present, linus 
requests the column values individually by name. 


2. control arg 

can be either -brief or -bf which specifies that verification of 
column values is not to be done. If not present, linus displays a list of 
selected column names, together with the column values as entered by the 
user, and requests that the user verify the correctness of the 
column _ values before the modification operation proceeds. If the 
verification is negative, the modification does not take place. Theuser 
may reenter the modify request without again specifying the associated 
query. 


Notes 


New column values may be specified in two forms: 1) as constants or linus 
variables which have previously been set, or 2) as arithmetic expressions combining 
constants, linus variables, and possibly. the name of the column being modified. All 
arithmetic expressions must be enclosed in parentheses. Anycharacter string values 
entered via the request line and containing embedded white space must be enclosed in 
quotes. 


The select clause of the associated query must specify columns from only one 
table, and only nonkey columns may be selected. The select clause associated with a 
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modify request may not contain arithmetic expressions, but is restricted to simpleor 
qualified column names. Also, no set operators (union, inter, or differ) may appear 
in the query. Thenull character string ("") may be used only when modifying the data 
Cypes: 


character 


character varying 
bit varying 


Examples 


Give every employee a 10 percent raise. The query is: 
linus: input query 
Query: 


select sal 
from emp 


The modification is accomplished when iteration is on by: 
linus: modify "(sal + .10 * sal)" 
sal = (sal + .10 * sal) 
OK? yes 
Al Jones has transferred to the shoe department. Update his employee record to 


indicate his new department and manager. The query is: 


linus: input query 


Query: 

select dept mgr 

from emp 

where name = "Al Jones" 


The modification may be specified by: 
linus: modify 


dept? Shoe 
mgr? 1234 


dept = Shoe 
mgr = 1234 
OK? yes 


linus: input _query 
Query: 

select floor 

from loc 

where dept = "Shoe" 
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Open 


The modification may be specified by: 


linus: modify 3 -brief 


Request: open, o 


_~ 


This request opens a specified MRDS data base for accessing in the designated 
opening mode. The data base may be designated either by the pathname of the data base 
itself, or by the pathname of a data submodel associated with the data base. Only one 
data base may be open at any given time. As an active function, it returns "true" if 
the data base was successfully opened and "false" if it was not opened. 


Usage 
o path mode 
Usage as an Active Request 


[o path mode] 


where: 

TV. path 
is the pathname of an MRDS data baseor ofa data submodel associated with 
an MRDS data base. Adata submodel is auser'sviewof the data base which 
may differ from the actual data base definition. See the MRDS Manual for 
a detailed discussion of data models and data submodels. 

2. mode 
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is the usage mode for which the data base is to be opened. Modes can be 
Specified either by their full names or by their abbreviations. 


exclusive retrieval, er 
indicates that the user wishes only to retrieve data from the data base, 
but that concurrent access by other users for update is to be prohibited. 


exclusive update, eu 
indicates that the user wishes to both retrieve and update information in 
the data base and that no concurrent access by other users is to be 
permitted. 


retrieval, r 
indicates that the user wishes only to retrieve data from the data base 
and allows concurrent access, for both update and retrieval, by other 
users. This mode requires that the user set scope for all tables to be 
touched (see the set_scope request). 


‘update, u 


indicates that the user wishes to both retrieve and update information in 
the data base and allows concurrent access, for both update and 
retrieval, by other users. This mode requires that the user set seope for 


all tables to be touched (see the set scope request). 
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Notes 


For secure data bases, non-DBA users will be required to use the pathname of a 
secure data submodel. Refer to the MRDS manual for definitions of DBA, secure data 
submodel, and secure data base. 


If the designated data base is already open by another user in a mode that 
conflicts with the mode designated in this open request, the open request is denied. 


Several data bases may be opened and closed during a linus session. However, 
only one data base may be open at any given time. 


Example 


Open the department store data base for nonexclusive retrieval. 


linus: open dept store retrieval 


Request: opened database 


This request (without the optional path), returns "true" if there is an open data 
base and "false" if there is no open data base. If path is provided, the request 
returns "true" if the specified mrds data base is currently open and "false" if the 
data base is not open. This request can only be used as an active request. 


[odb {path}] 


where path is the pathname of a mrds data base or data submodel associated witha mrds 
data base. 


linus: string Lopened_ database] 
false /* there is no currently open data base */ 


linus: string [opened database] 
true /* there is a currently open data base */ 


linus: string [opened_database foo] 
faise /* the foo data base is not currently open */ 


linus: string Lopened database foo] 
true /* the foo data base is currently open *#/ 
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picture print 


Request: picture, pic 


This request returns one or more values processed through a specified PL/I 
picture. 


Usage 


pie pic_ string values {-control_arg} 


Usage as an Active Request 
[pic pic string values {-control_arg}] 


where: 
1. pic_string 
is a valid PL/I picture as defined in the PL/I Reference Manual and the 
PL/I Language Specification. 
2. values 
_are strings having data appropriate for editing into the picture. Each 
value must be convertible to the type implied by the picture specified. 
If multiple values are presented, the results are separated by single 
.Spaces. Any resulting value that contains a space is quoted. 
Be eontrol_arg 
-strip 
removes leading spaces from edited picture values; removes trailing 
zeros following a decimal point; removes a decimal point if itis the last 
character of a returned value. 
Notes 


For more information on PL/I picture and picture strings, see the PL/I Reference 
Manual, (Order NO. AM83) or the PL/I Language Specification (Order No. AG94) 


Examples 


The editing request in a formatted report: 
[picture $99,999v.99 [column value salary]] 


returns the value $27,922.41 if the value of the salary column was 27922.41. 


Request: print, pr 


This request specifies that selected data is to be retrieved and displayed on the 
user's terminal. The selected columns are displayed side-by-side with optional 
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print 


print 


column headers. The user may specify that a limit be placed on the number of rows to be 


displayed. 


Usage 


A translated or translatable query must be available. 


pr {-control args} 


where control args can be one or more of the following: 


-all, 


-col 


-col_ 


-max 


-a . 
specifies that every row of information is to be displayed. The user is 
not queried. 


widths wi... wn, -cw wl... wn 

“explicitly specifies the width of each column to be displayed (in 
characters). If not present, the widths assume default values 
ealculated from the data base definition of the items selected, or 
lengths of the column headers, whichever is larger. If this control 
argument is present, the specified widths must correspond in order and 
quantity to the items in the lila select clause. The column header is 
truncated if its length is greater than the column widths given. The wi 
may be integers or may be specified as "p.q", where p and q are precision 
and scale, respectively, of numeric data. Asterisks are printed if 
retrieved data cannot be printed in the column widths specified. 


widths trunc, -cwt 

is identical tothe -cwceontrol argument except that truncation occurs in 
cases where retrieved data contains more characters than the column 
widths specified. This argument is not compatible with -col_widths. 


N 


where N is a positive integer s 


ifvi 

ifying that no more than s of 
information are to be displayed. If there are more than N rows, the user 
is queried as to whether more information is desired. Allowed responses 
to this query are: yes, to continue printing data and query after Nmore 
data lines are printed; no, to stop printing; or all, to print all 
remaining data without query. If -max Nis not given, N is set to 10. 
This argument is incompatible with -all. 


-no_end 


specifies that the string "(END)" is to be suppressed when there is no 
more data to be printed. 


-no_header, -nhe 


Notes 


specifies that column headers are not to be displayed. If not present, 
column headers consisting of column names are displayed if columns are 
selected. If an expression is selected, the column header is f(name), 
where name is the table or row designator name for the data base items 
appearing in the expression. 


The columns are displayed side-by-side. The width of each column is determined 
from the data descriptions in the data base. Each column is separated from the next by 


two blanks. 
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There is no pagination. 
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print qedx 


Tne current maximum total length for columns, two space separators, andtrailing 
newline characters that make up the print line is 5000. 


Example 


Display the names of all employees in the shoe department, together with the sums 
of their salaries and commissions. The query is: 


linus: input query 
Query: 

select name sal + comm 
from emp 

where dept = "Shoe" 


The retrieval is accomplished as follows: 


linus: print 


name F (emp) 
John Smith 10000 
Al Jones 12000 
Carol Anderson 8000 
Betty Johnson 11000 
(END) 


Request: print_query, pq 


This request prints (displays) or returns the current query. 


Usage 


Pq 


Usage as an Active Request 


Cpq] 


Request: gedx, qx 


This request invokes the qedx editor with the current query, or anewquery. The 
edited query becomes the current query if the changes are saved before terminating 
qedx. 
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qedx , report 


Usage 
qx {-control_args} 


where control _args can be chosen from the following: 


-new 
specifies that qedx be given an empty buffer when invoked. 


-old 
' specifies that the existing query be made available for editing with 
qedx. (Default) 


The user must write (save) the changed query for it to become the current query. 


Request: quit, q 
This request terminates the linus session. If a data base is open at tne time of 


this request, it is automatically closed. 


Usage 


Request: report, rpt 


~~ This request specifies that selected data is to be retrieved and used to generate ™ 


a formatted report via the report I/0 module and an existing Multics Report Program 
Generator (MRPG) object module. Refer to the MRPG Manual for a complete description 
of the MRPG facility. A translated or translatable query must be available when this 
request is specified. 


Usage 
rpt arg string 


where arg string is a character string that must begin with the name of the MRPG object 
module, and must also contain any arguments required by the MRPG object module. 
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report — restore _format_options 


The report is created by attaching the report file via report_ and opening it in 
stream output mode. Each set of selected values is written as a line through report_. 
Within the MRPG program, the input from linus must be declared with the attribute, 
Special. 


Example 
al Ne 


Create a formatted report containing the name, department, and salary of every 
employee. Assume that the MRPG object module, emp_report, creates the desired 
report. The query is: 

linus: input query 

Query: 

select name dept sal 

from emp 


The report is created by the following request: 


linus: report emp report 


Request: restore _format_options, rsfo 


This request restores the saved report layout specified by path. Only the 
formatting options found in the saved report layout have their values changed. 


Usage 


rsfo path 


where path is the pathname of the saved report format to be restored. If path does not 
have a fo.lec suffix, one is assumed. 


Notes 


Refer to the save format options request for detail on the content of the saved 
report format. 


Examples 


restore format_options sample display format 


restore format options another_display format.fo.lec 
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rtrim save format_options 


Request: rtrim 


This request returns a character string trimmed of specified characters on the 
right. 


Usage 


rtrim STRa {STRb} 


Usage as an Active Request 


{rtrim STRa {STRb}] 


Notes 


The rtrim active function finds the last character of STRa not in STRb, trims the 
characters from STRa following this character, and returns the trimmed result. Space 
characters are trimmed if STRb is omitted. 


g C(rtrim 000305.000 0] 
aye 


string C[rtrim [ltrim 000305.000 0] 0] 


td 
r< 


string X[rtrim " This is it. " 
X This is it.Y 
-Request: save format_options, svfo 


This request saves the current values of format options as a linus subsystem 
exec com. The saved format can be restored with the restore format_options request. 
The file is saved with a fo.lec suffix. Individual format options, active format 
options, or all of the format options can be saved. The query can also be saved. 


Usage 
svfo path {-format_option_args} {-control_args} 


where: 
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Save format_options save format_options 


Ts 


2. 


3. 
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path 


format_ 


is the pathname of the segment that contains the saved format. If path 
does not have a fo.lec suffix, one is assumed. 


option args 

refer to the set_format_options request for a complete description of the 
format option arguments. Each format option named has its value saved in 
the exec_com specified by path. These arguments are incompatible with 
the -all and -active control arguments. 


GENERAL REPORT OPTIONS 


“-delimiter, -dm 


-format_document_controls, -fde 
-hyphenation, -hph 

~page footer_value, -pfv 

-page_ header_value, -phv 

-~page length, -pl 

-page width, -pw 

-title line, -tl 

-truncation, -tc 


GENERAL COLUMN OPTIONS 


-column_order, -co 

-count, <-ct 

-exclude, -ex 

-group, -gr 

-group footer_trigger, -gft 
-group footer_value, -gfv 
-group_ header trigger, -ght 
-group_header_value, -ghv 
-outline, -out 

-page_ break, -pb 
-row_footer_value, -rfv 
-row_header_value, -rhv 
-subcount, -sct 

-subtotal, -stt 

“total, -tt 


SPECIFIC COLUMN OPTIONS 


-alignment, -al 
-editing, -ed 
-folding, -fold 
-separator, -sep 
-title, -ttl 
-~width, -wid 


control _ args 


can be one or more of the following: 


-active, -act 


-all, 


Specifies that only the active formatting options are to be saved. 
(Default) Type “help formatting options.gi" for more information on 
active formatting options. This control argument is incompatible with 
the format option arguments and the -all control argument. If -active 
and -all are given, the last one supplied is used. (Default) 


-a 

Specifies that all formatting options are to be saved. This control 
argument is incompatible with the format option arguments and the -active 
control argument. If -all and -active are given, the last one Suppiied is 
used. 
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save format options | . sSet_format options 


-query 
specifies that the current query is to be saved. A 
restore _format_options on the saved format also restores and makes the 
saved query current. 


Examples 


save format options report_layout 

save format_options report_layout -all 

save format_options report layout -query 

save format_options report layout -page header_value -page footer_value 
save format_options report_layout -page header_value -width salary 


save format options report_layout -width ** -page footer_value 


Request: save_query, sq 


This request takes the current query and saves (writes) it to a file. 


where path is the name of the saved file. If not present, a suffix of lquery is added to 
path. 


Request: set_format_options, sfo 


.._—This request sets individual report format options to user-specified or default | 
values, and/or all formatting options to default values. 


Usage 


sfo {-format_option_args} {-control_args} 


NOTE: The option value given for any format option argument can be the control 
arguments -default or -prompt. If -default is given for the value, linus 
sets the value of the format option to the system default. If -promptis 
given for the value, linus prompts for the value with the prompt string 
"Enter FORMAT OPTION NAME.". A line consisting of the single character 
"." terminates the prompted input mode. To suppress display of the 
prompt string, use the -brief control argument. 
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set_format_options set_format_options 


where: 


1. format_option_args 
ean be one or more of the following: 


Note: The following list identifies all format option 
arguments grouped by function. The argument 
descriptions are listed alphabetically, immediately 
after the function groupings. . 


GENERAL REPORT OPTIONS 
-delimiter, -dm 
-format_document_controls, -fde 
-hyphenation, -hph 
-page footer_value, -pfv 
-page header_value, -phv 
-page length, -pl 
-page width, -pw 
-title line, -tl 
-truncation, -te 


GENERAL COLUMN OPTIONS 
-column_order, ~co 
-count, -ct 
-exclude, -ex 
~group, ~gr 
-~group footer _trigger, -gft 
~group footer value, -gfv 
-group_header_trigger, -ght 
-group header_value, -ghv 
-outline, -out 
-page break, -pb 
-row_footer_value, -rfv 
-row_header_value, -rhv 
-subcount, -set 
-subtotal, -stt 
-total, -tt 


SPECIFIC COLUMN OPTIONS 
-~alignment, -al 
-editing, -ed 
-folding, -fold 
~separator, -sep 
-title, -ttl 
-width, -wid 


-alignment column_id STR, -al column_id STR 

column_id (see "Notes") specifies which column the alignment applies to 
and STR is the alignment mode. STR can be set to center, left, right, 
both, or decimal N. The default value for STR depends upon the type of 
column selected. Character and bit strings default to left alignment, 
decimal data with a non-zero scale defaults to decimal point alignment, 
and all other types default to right alignment. For decimal alignment, 
the decimal alignment position within the display width is given a 
default value. This alignment position can be changed by specifying the 
value as “decimal N", where N is the character position within the 
display width where the decimal point is aligned. The alignment mode 
"both" specifies that the column value is aligned to the leftmost and 
rightmost character positions within its display width. Text is padded 
by insertion of uniformly distributed whitespace if necessary. 


-column_order column_list, -co column_list 
column list determines the order in which columns appear in the detail 
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set_format_options set_format_options 


line. eolumn list can be set to a list of column names or numbers. 
Columns missing from this list are placed after the columns which appear 
in thelist. Thatis, if five columns were selected and the column order 
value is given as "3 2", the complete order would be "3 2 17 4 5", 
(Default value for column List is the list of columns from the query, in 
the order supplied, meaning that the columns appear in the exact order as 
they appear in the query. 


-count column_list, -ct column_list 

eolumn_ list determines the columns for which counts are generated. 

column list can be set to a list of column names or numbers. Counts are 
generated after the last detail line. If acount is requested ona column 
that is excluded, the count is also excluded from the page. An exception 
to this rule is when all columns are excluded. Counts are provided in 
this case to allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. (Default value for column_list 
is "", meaning no columns have counts generated. 


-delimiter CHAR, -dm CHAR 
CHAR is the character used to delimit the different portions of a header 
or footer and can be set to any printable character. (Default value for 
CHAR is "!",) 


-editing column id STR, -ed column id STR 
STR specifies the additional editing to be done to the column value before 
it is placed on the page and column_id (see "Notes") specifies which 
column the editing applies to. Multics active functions and linus active 
requests are normally used to provide additional editing. For example, 
the editing value: 


[pic $99,999v.99 [column_value salary]] 


places commas and dollar signs in the "salary" column. (Default value 
for STR is "", meaning additional editing is not done.) 


Refer to the column_value request for a description of usage. 
-exclude column list, -ex column_ list 

column list determines if any of the columns selected in the query are 

excluded from the detail line. column list can be set to a list of column 

names or numbers. (Default value for column list is "", meaning no 

columns are excluded.) 


-folding column_id STR, -fold column_id STR 
STR determines what type of action occurs when a column value exceeds its 
display width and column_id (see "Notes") specifies which column the 


folding applies to. STRset to "truncate", means the value-of-theeohimn—-—-- 


is truncated to fit in the display width and the truncation character(s) 
is placed at the end of the value to indicate truncation occurred. 
(Default value for STR is "fill," meaning portions of the value which 
exceed the display width are moved down to the next line(s) until a 
correct fit is obtained.) 


-format document controls STR, -fde STR 
STR determines if the format_document_ subroutine is to interpret format 
document eontrol lines when filling overlength text. STR can be set to 
*on,* meaning format document _ interprets control lines in the text and 
provides special filling actions based on the embedded control lines. 
(Default value for STRis "off," meaning format_document does not check 
for control lines embedded in text.) 


-group column list, -gr column list 
eolumn list. determines the grouping of a number of rows based on the 
values of one or more columns. column list ean be set to a list of column 
names or numbers. The column or columns named in the list become a 
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set_format_ options set_format_options 


8/86 


hierarchy of columns. The first column named is the major column, and the 
last column named becomes the minor column. The hierarchyof columns can 
be used with the outline, page break, and subtotal options described 


- below. (Default value for column _ list is"", meaning no group of rows is 


defined.) 


~group footer _trigger column list, -gft column list 


column_list determines when to generate the group footer. column_list 
can be set toa list of column names or numbers. The columns which appear 
in this list must also appear in the column list associated with the 
-group option. If the -group option is set to anewvalue, columns which 
are eliminated from the column_list are also eliminated from the 
~group footer_trigger column_ list. When any of the columns specified in 
the column _ list are about to change with the next row, the group footer is 
evaluated. The group footer is always evaluated after the last rowof the 
report. (Default value for column_list is "", meaning no group footer 
triggers are defined.) 


-group footer_value STR, -gfv STR 


STR is the group footer placed after each group of rows when any of the 
columns associated with the -group footer_trigger option changes. 
Refer to the description of -page footer_value above for the content ofa 
header/footer. (Default value for STRis "", meaning there is no group 
footer defined.) 


-group header_trigger column list, -ght column_list 


column list determines when to generate the group header. column_list 
ean be set toa list of column names or numbers. The columns which appear 
in this list must also appear in the column list associated with the 
-group option. If the -group option is set to a new value, columns which 
are eliminated from the column_list are also eliminated from the 
-group_header_trigger column list. When anyof the columns specified in 
the column list have just changed with the current row, the group header 
is evaluated. The group header is always evaluated before the first row 
of the report. (Default value for column_list is "", meaning no group 
header triggers are defined.) 


~group_header_value STR, -ghv STR 


STR is the group header placed before each group of rows when any of the 
columns associated with the -group_header_trigger option changes. 
Refer to the description of -page_ footer_ value above for the content ofa 
header/footer. (Default value for STRis "", meaning there is no group 
header defined.) 


-hyphenation STR, -hph STR 


the value of -hyphenation determines if hyphenation is to be attempted 
when filling overlength character strings. STR can be set to "on," 
specifying that hyphenation is to be attempted. (Default value for STR 
is "off," meaning no hyphenation is attempted.) 


-outline column list, -out column_list 


column_list determines if duplicate values in a column are to be 
suppressed. column_list can be set toa list of column names or numbers. 
If the value of a named column is the same as its previous value, then the 
value is suppressed unless it is the first line of a new page. (Default 
value for column list is "", meaning no columns have duplicate values 
suppressed.) 


If any of the named columns are a member of the "group" of rows defined by 
the group option, then it, and all of the columns more major in this group, 
are outlined. A change in value of any one column displays all columns 
lower in the hierarchy in addition to the column that changed. An 
exception is the first line on a new page, in which case duplicate values 
are never suppressed. 
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-page break column_ list, -pb column list 


eolumn_ list determines when page breaks are generated. column list can 
be set to a list of column names or numbers. The columns specified in the 
list are examined, and when their values change, a new page break is 
generated. If anyof the named columns area member of the "group" of rows 
defined via the group option, then it, and all columns more major in the 
group, are examined for page breaks. (Default value for column_list is 
ut meaning that no columns are examined for page breaks.) 


-page footer_value STR, -pfv STR 


STR is the page footer placed at the bottom of each page. The page footer 
ean consist of more than one line, and each line can have a left, right, 
and center portion. The individual portions of each line are delimited 
by the delimiter character. Active requests found in the footer are 
evaluated and their return value is placed into the footer before folding 
and alignment takes place. Portions of a footer with zero length have 
their space on the page redistributed to the other portions whose lengths 
are not zero. For example, if the page footer contained only a center 
portion: 


!!Sample Center Portion!! 


the text is centered on the page and has the full page width available for 
the text. Similarly, a left portion or right portion only is aligned to 
the left or right of the page and has the full page width available for 
placement of text. Two exceptions tothis action are when the footer has 
a left, right, and center portion, and the left or right portion has a zero 
length, such as: 


Sleft part!center part!! 
or 
'!oenter part!right part! 


in which case the left or right part of the page is unavailable for 
placement of text (i.e., the space is not redistributed to the other two 
portions). If the redistribution of the available page width is not 
desired, the placement of a single blank into a portion such as 
"!<SP>!Center Part!<SP>!" prevents the redistribution from taking 
place because each portion has a length greater than zero. (Default 
value for STRis"", meaning there is no page footer provided by default.) 


-page header value STR, -phv STR 


STR is the page header placed at the top of each page. Refer to the 
description of -page footer value for the content ofa header. (Default 


—vValue-forSTR-is meaning there is nopageheader provided by default.) 


~page length N, -pl N 


N is the length of each formatted page given as number of lines. Ncan be 
given as "0" or any positive integer. "0" means the report is not to be 
Daginated and is created as one continuous stream. (Default value for! 
is 66.) 


-page width N, -pw N 


N is the width of each formatted page given as the number of character 
positions. Ncan be given as "O" or any positive integer. "0" means the 
page width is always set by linus to be the exact width needed to contain 
all of the columns specified in the query. If Nis greater than zero and 
the width for any column exceeds N, the width of the column is 
automatically set to N. (Default value for N is 79.) 


-~row_footer_value STR, -rfv STR 


STR is the row footer placed after each detail line. Refer to the 
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description of -page footer_value (above) for the content ofa footer. 
(Default value for STRis "", meaning that no row footer is provided.) 


-row_header_value STR, -rhv STR 


“STR is the row header placed before each detail line. Refer to the 
description of -page footer_value (above) for the content of a header. 
(Default value for STR is "", meaning that no row header is provided.) 


-separator column_id STR, -sep column_id STR 


STR separates a column from the next one following it and column a (see 
"Notes'") specifies which column the separator applies bo. Th last 


column on a line does not have a separator. STR can be any eeauet ce of 
printable characters. (Default value for STR is "<SP><SP>".) 


-subcount subcount spec, -set subcount_spec 


subcount_spec determines what columns subcounts to generate, when they 
should be generated, and what type of subcount is generated. (Default 
value for subcount_ spec is "", meaning that no subcounts are generated 
for any columns.) 


subcount spec can consist of one or more blank-separated "triplets." 
The syntax of a triplet is: 


column _1,column 2{reset ; running} 
wnere: 


column 1 
is the name or number of the column for which a subcount is 
generated. 


eolumn 2 
“is the name or number of a column whose value is examined to 
determine when to generate the subcount. When the value of the 
column being examined changes, the subcount is generated. If 
this column is a member of the group of rows defined via the 
"group" option, it, and all columns more major in the group, are 
examined for subcount generation. 


reset | running 
indicates the type of subcount desired. If reset is selected, the 
Subcount counter is reset to 0 each time a subcount is generated. 
If running is selected, the subcount is not reset to 0. If a 
subcount is requested on a column that is excluded, the subcount 
is also excluded from the page. An exception to this rule is when 
all columns are excluded. Subcounts are provided inthis case to 
allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. (Default is "reset.") 


-subtotal subtotal spec, -stt subtotal _ spec 


subtotal spec “determines what column subtotals to generate, when they 
should be generated, and what type of subtotal is generated. (Default 
value for subtotal _specis "", meaning no subtotals are generated for any 
columns.) 


subtotal spec can consist of one or more blank-separated triplets. The 
syntax of a triplet is: 


column_1,column 2{,reset {| running} 
where: 
column 1 


is the name or number of the column for which a subtotal is 
generated. 
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column 2 
is the name or number of a column whose value is examined to 
determine when to generate the subtotal. When the value of the 
column being examined changes, the subtotal is generated. If this 
column is a member of the group of rows defined via the "group" 
option, it, and all columns more major in the group, are examined for 
Subtotal generation. 

reset | running 
indicates the type of subtctal desired. If reset is selected, the 
subtotal counter is reset to 0 each time a subtotal is generated. If 
running is selected, the subtotal is not reset to 0. If a subtotal 
is requested on a column that is excluded, the subtotal is also 
excluded from the page. An exception to this rule is when all 
columns are excluded. Subtotals are provided in this case to allow 
reports consisting of some combination of counts, subcounts, 
totals, and subtotals only. (Default is "reset.") 


-title column id STR, -ttl column id STR 


STR is the title placed above the column at ene start of each page if the 
title line option is set "on" and column_id (see "Notes") specifies which 
column the title applies to. (Default value of STR is the name of the 
column taken from the open model or submcdel. In thecasecf expressions, 
the default value for STRis "eN", where N begins at 1 andis incremented 
by 1 for each additional expression found in the select list. If the 
title is not the same number of characters as the display width of the 
column, the title is centered within the display width for its associated 
column. If the value of title is wider than the display width of the 
column, it is filled or truncated to obtain a correct fit, depending on 
the folding action of the parent column.) 


-title line STR, -tl STR 


STR determines if atitle line is to be printed. STRean be set to "off" to 
inhibit the printing of the title line. (Default value of STR is "on," 
meaning a title line is printed at the top of each page.) 


-total column list, -tt column_list 


column list determines what column totals to generate. (Default value 
for column list is "", meaning no totals are generated for any columns.) 


column list can be set toa list of column names or numbers. Totals are 
generated after the last detail line. If atotal is requested ona column 
that is excluded, the total is also excluded from the page. An exception 
to this rule is when all columns are excluded. Totals are provided in 
this case to allow reports consisting of some combination of counts, 
subcounts, totals, and subtotals only. 


-truneation STR, -te STR 


STR determines the character(s) to be used to indicate truncation of some 
value. STR can be set to any sequence of printable characters. (Default 
value for STR is #.) 


-width column_id N, -wid column_id N 


N determines the display width for a column and column id (see "Notes") 
specifies which column the width applies to. Ncan be set to any positive 
integer. (Default value for N is the number of character positions 
needed to contain the value, after conversion from the data type foundin 
the data base, to character format.) 


control args 


ean be chosen from the following: 
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set_format_options set_format_options 


-brief, -bf 
specifies that the prompt string for values is not to be displayed. If 
the -brief and -long control arguments are both entered on the request 
line, the last one supplied is used. 


~default 
specifies that linus set the value of the format option which immediately 
precedes this control argument to the system supplied default. 


-long, -lg 
displays "Enter FORMAT OPTION NAME" prompt string for values when the 
-prompt control argument is provided. (Default) If the -brief and -long 
control arguments are both entered in the request line, the last one 
supplied is used. 


-no_reset, -nrs 
~ specifies that formatting options are not to be reset to system default 
values. (Default -- only user-specified options can be changed.) If the 
~reset and -no_reset control argument are both entered in the request 
line, the last one supplied is used. 


~prompt 
specifies that linus prompts for the value of the format option which 
immediately precedes this control argument. A prompt string is written 
before the prompting action unless the -brief control argument is used. 
A line consisting of the single character "." terminates the prompted 
input mode. 


-resets, -rs 
specifies that all formatting options are to be reset to system default 
values before the values are changed for any other format options 
specified in the request line. If -reset and -no_reset are both entered 
in the request line, the last one supplied is used. 


-string STR, =+str STR 
enters STR as a format option value when STR begins with a hyphen. 


Notes 


. The variable column_id identifies the column name as defined in the open 
model/submodel, the number of the column in the query, or a star name which is used to 
match column names. If more than one table name is used in a select statement, the 
column_name is fully qualified (e.g., "table name.column_ name", or 
"row _designator.column_ name"), otherwise the table name is unqualified (e.g., 
"table name"). 


At least one format option argument or the -reset control argument must be 
specified. Format option arguments and control arguments can be mixed freely in the 
request line, but acontrol argument cannot be placed between a format option name and 
a format option value. For example: 

set_format_options -page width 80 -reset 
is a valid request, but 

set_format_options -page width -reset 80 
is not valid. If a value is to be set that begins with a hyphen, the -string control 


argument must be given before the value, to distinguish it from control arguments and 
format option arguments. 


8/86 5-62 AZ49-03A 


set_format_options | set_mode 


Example 


set _format_options -width 1 25 

set_format_options -title emp _name "Employee Name" 

set format options -reset -page width 80 -page length 60 

set_format_options -page footer_value "t!-(display_ builtins page _number]-!!" 
set _format_options -page header_value -prompt 


Enter page header value. 


!tlexecute date] !LINUS REPORT![execute time]! 
greg 


iL 0 
!!--Page [display_ builtins page_ number ]--! 


set_format_options -exclude exchange extension -width area_code le 


set format options -editing area_code "[format_line “a/“a-“a [column_value area_code! 
Teolumn_ value exchange] Ceolumn_ value extension]]" 


Request: set_mode, sm 


This request sets or resets the specified mode and changes the prompt strings. 


Usage 


sm {model...modeN} 
where modei may be one of the following: 


iteration 
turns on request line iteration processing. 


“iteration 
turns off request line iteration processing. (Default) 


prompt 
turns on prompting. (Default) 


“prompt 
turns off prompting. 


set_linus_prompt_string STR, slups STR 


sets the linus prompt string to STR. If there are embedded blanks in STR, 
then STR must be enclosed in quetes. (Default is "linus:") 


set_lila_ prompt string STR, slaps STR 
sets the lila prompt string to STR. If there are embedded bianks in STR, 
then STR must be enclosed in quotes. (Default is "->") 
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set_mode set_scope 


= 
° 
et 
o 


The maximum prompt string length is 32 characters. 


Example 


Turn off prompting mode. 


linus: set_mode “prompt 


Request: set_scope, ss 


This request allows the user to define the current scope of access to the data 
base for nonexclusive opening modes. This request and the del _ scope request are the 
means through which the user defines requirements to the linus concurrent access 
control mechanism. Every table that theuser wishes to access for a given period must 
be included within the user's scope of access for that same period. As an active 
request, it returns "true" if the scope was set and "false" if the scope was not set. 


For every table to be included in the current scope, the user specifies the types 
of access required, and also those types of access which are to be prohibited to other 
users. The scope of access is a dynamic entity, and may be varied toreflect theuser's 
changing requirements during the life of a linus session. In order to prevent 
deadlock situations the current scope must be set to null with the del_scope request 
prior to issuing a set scope request. 


Usage 


Ss table namel permit_opsi prevent_opsi {... table_namen permit_opsn 
prevent _opsn} {-control_arg} 


Usage as an Active Request 


[ss table namel premit_ops1 prevent _ops1 tie pe table_namen permit _opsn 
prevent_ops_} {-control_arg}] 


where: 


1. table namei 
is the name of a nontemporary table within the data base that is to be 
included in the current scope of access. ; 


2. permit _opsi 
is a character string indicating which types of data base operations are 
to be permitted the user who is setting scope for the corresponding table. 
The character string is the concatenation of the codes for all operations 
to be permitted. See "Notes" for a aescription of the operation codes. 


3. prevent _opsi 
is a character string similar to that for permit_opsi indicating which 


8/86 5-64 AZH9-O3A 


set_scope . set_scope 


types of data base operations are to be denied other users for the 
eorresponding table. 


4, control arg 
may be either -time seconds, or -tm seconds where seconds is an integer 
that specifies the wait time in seconds to be allowed for the requested 
scope to be granted. The default wait time is 30 seconds. If the 
requested scope cannot be granted within the specified wait time, the 
user is notified of the denial and may try again or may take other 
appropriate action. 


Notes 


Codes for operation types to be permitted or prevented are: 


Code Operation 


delete 

modify 

null 

retrieve 

store 

update (store, modify, delete) 


cuns3ag a 


It is recommended that users declare the minimum access scope necessary for any 
given operation and that the scope be maintained for only as long as it is needed. 
Declaration of unnecessarily large scopes is discouraged, as other users may be 
needlessly locked out of the data base. 


The set scope request is denied if the user currently has a nonnull scope in 
force. Therefore, all of the user's access scope must be deleted with a del_scope 
request prior to issuing a set_scope. The set_scope request must then specify the 
entire scope of access required by the user for a block of operations. This is in 
contrast to the del_ scope request, where portions of the current scope may be deleted. 


If another user has a conflicting scope in force, the set_scope request is denied. 


Specification of a modify, store, or delete permit _cp causes a retrieve 
permit _op for the same table to be automatically requested. 


The null (n) scope operation code is ignored, unless given by itself. 


Example 

Jim Jones, the manager of the shoe department, has retired and is being replaced 
by Al Smith. Update the employee table to reflect these changes, while ensuring that 
no other users access inconsistent data. This may be done in two steps. 


Step One: Do the necessary retrieves 


linus: input query 


Query: 
‘select emp_no from emp 
where name = "Al Smith" 


linus: set _scope emp rn 
linus: assign values !smith_no 
linus: qedx 
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set_scope | store 


2s/Al Smith/Jim Jones/ 


1,$ p 

select emp no from emp 
where name = "Jim Jones" 
write 

quit 


linus: assign values !jones_no 
Step Two: Modify and delete 


linus: qedx 
1s/emp_no/mgr/ 


2s/name = "Jim Jones"/mgr = !jones_no 
1, $p 

select mgr from emp 

where mgr = !jones_no 

write 

quit 


linus: del_scope * 

linus: set_scope emp dm rdms 
linus: modify !smith_no -brief 
linus: gqedx 


1s/mgr/*/ 

2s/mgr/emp_no/ 

1,$ p 

select * from emp 

where emp no = !jones_no 
write 

quit 


linus: delete 
linus: del_scope * 


Notice that the only time it is necessary to prevent access to other users is 
while modify and delete are being accomplished. 


Request: store, s 


This request adds newrows to a designated table in the data base. The data base 
must be open for update or exclusive update. If open for update, the table being 
stored must be within the current access scope for the store operation. Values being 
stored may be specified in one of three ways: 1) directly within the request line, 2) 
interactively in response to linus prompting, or 3) by placing the values ina Multics 
file and supplying the pathname as a control argument in the store request line. Using 
the first two methods, only a single row may be stored with one store request, whereas 
the third method (file input) allows the storing of multiple rows. Moreover, if the 
new rowis being entered from the terminal (as opposed to file input), theuser has the 
option of verifying the values prior to their being stored into the data base. (Also 
see the store _from_data_ file request.) 


Usage 


s table name {column_values} {-control_args} 
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store 


where: 


store 


1. table name 


is the name of the table to which rows are being added. This must be the 
name of a nontemporary table. 


2. column values 
“are optional arguments and, if present, specify the column values 
comprising thenewrowbeing added. The column_values must be specified 
in the same order that the corresponding columns appear in the data base 
or the data submodel, whichever is applicable. Also, exactly one value 
must be specified for every column defined in the data base or data 
submodel. 
3. control _args 
can be one or more of the following: 
-brief, -bf 


specifies that verification of column values is not to be done. If not 
present, and if the ~input_file control argument is not present, linus 
displays a list of column names, together with the column values entered 
by the user, and requests that the user verify the correctness of the 
column values before the store operation proceeds. If the verification 
is negative, the store does not take place, and the user must reenter the 
store request. 


~column delimiter CHAR, -cdm CHAR 


specifies that each column value, in the file specified via -input file, 
is separated from the next by the CHAR character. This control argument 
has meaning only if specified together with -input file. If not present, 
each column_value is assumed to be delimited by one or more blanks. 


-input_file path, -if path 


specifies that the column_values are to be taken from the Multics file 
designated by path. path is the pathname designating a Multies file 
suitable for processing byvfile_ inthe stream_input opening mode. See 


"Notes" for a detailed description of the input file. 


-row_ delimiter CHAR, -rdm CHAR 


Notes 


specifies that each row value is Separated from the next by the CHAR 
character. If not present, each row value is assumed to be delimited bya 
newline (NL) character. 


If column_values are not present in the request line and -input_file is not 
specified, then linus requests each column value individually by name. 


If -input_file is specified, the input file may contain column_values for more 
than one row. The input for each row is terminated by a newline character or the row 
delimiter character, if specified. In all cases, column_values are separated by 
blanks unless another delimiter is specified via -column_delimiter. 


Examples 


Add a new supplier to the supply table. 


linus: 


8/86 


store supply Acme 10 2006 
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Store . store from data file 


Supplier = Acme 


item = 10 
vol = 200 
OK? yes 


Another way of performing the operation is: 


linus: store supply -brief 


supplier? Acme 
item? 10 
vol?. 200 


Request: store_from_data file, sdf 


This request reads data from afileand loads it into the specified table. It may 
J be used to reload data written by the write data file request. 


Usage 


sdf table name -control_args 
where: 


1. table name 
is the name of the table defined in the open model or submodel. 


2. control args 
ean be chosen from the following: 


-column delimiter CHAR, -cdm CHAR 
where CHARis a single ASCII character used to delimit the column values. 
(Default column delimiter is the tilde.) 


-input_file pathname, -if pathname 
specifies the name of the file which contains the input data. 


-row_delimiter CHAR, -rdm CHAR 
where CHAR is a single ASCII character used to delimit the row values. 
(Default row delimiter is the newline (NL) character.) 


Note 


One level of quotes is removed from each column value, if present. 


Examples 


Store from_data_file employee -if employee data 
store from_data_ file employee -if employee data -cdm X -rdm Y 
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store from_data_file subsystem _name 


Several rows could be added to the supply table by first creating the following file 
with a text editor: 


Acme, 10, 200, 
KYZ,.12; 150, 
J. Smith, 10,100, 


and then entering the following request: 


linus: store_from_data_file supply -input_file supply file 
-column_ delimiter, 
Request: string 


This request returns a single character string formed by concatenating all of the 
strings together, separated by single spaces. 


Usage 


string {STRs} 


Usage as an Active Request 
[string {STRs}] 


If no STRs are specified, a null character string is returned. If one or more 
STRs are specified, any quotes are returned as single quotes. 


Examples 


string He said, "Hi." 
He said, Hi. 


string He said, """Hi,wu1 
He said, "Hi." 


string [string This is "food". ] 
This is food. 


Request: subsystem name 


This request displays the name of the subsystem. As an active request, it 
returns the name of the subsystem. 
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subsystem_name translate query 


Usage 


subsystem_name 


Usage as an Active Request 


Csubsystem_name] 


Request: subsystem_version 


_ This request displays the version number of the subsystem. As an active request, 
it returns the version number of the subsystem. 


Usage 


Subsystem_version 


Usage as an Active Request 


[subsystem_ver sion] 


Request: translate query, ta 


This request translates the current query and makes it available for linus data 
manipulation requests. 


Usage 


tq 


“Note 


‘Refer to Section 1 for examples of query statements. 
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write write 


Request: write, w 


This request specifies that the selected data is to be retrieved and written toa 
specified Multics file. The output file is a text file created by vfile_ in the 
stream output mode. If the file already exists, it may optionally be extended, 
although normally it would be truncated. A translated or translatable query must be 
available. 


Usage 


w outfile {-control_args} 
where: 


1. outfile 
is the pathname of a Multics file into which the selected data is to be 
written. If the file does not currently exist, it is created. If the 
file currently exists, itis truncated unless -extend is also specified. 


ae control args 
may be one or more of the following: 


-extend 
Specifies that if the outfile exists, it is to be added to, rather than 
truncated. 


-column delimiter CHAR, -cdm CHAR 
Specifies that each selected value is to be delimited by the CHAR 
character in the outfile. If not present, each selected value is 
delimited by one blank. 


-row_delimiter CHAR, -rdm CHAR 
specifies that each row is to be delimited by the CHAR character in the 
outfile. If not present, each row is delimited by a newline (NL) 
character. 


The output file is a text stream file created by vfile_. Each set of selected 
values is delimited by a newline character or the row delimiter character, if 
specified. The output file is suitable for processing by a text editor, as well as 
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write write data file 
other Multics facilities which process ASCII text files. 


Example 


Create a text file consisting of the name and salaryofevery employee. Thequery 
iss 
linus: input query 
Query: 
select name sal 
from emp 
The text file may then be created by: 


linus: write salary file 


Request: write data file, wdf 


This request retrieves the selected data and places it in an output file, ina 
format suitable for input to the store from _data_ file request. 


Usage 


wdf pathname {-control_ args} 


where: 
1. pathname 

is the name of the file where the data is to be written. 
ae control args 


can be chosen from the following: 


-column delimiter CHAR, -cdm CHAR 
where CHARis a single ASCII character used to delimit the column values. 
(Default column delimiter is the tilde.) 


-create columns STR, -ere STR 
STR specifies the column positions for newcolumns with null values. STR 
is a blank-separated list of numbers. (See "Notes" below. ) 


-extend 
Specifies that if the file already exists, it should be extended rather 
than truncated. 


-row delimiter CHAR, -rdm CHAR . 
where CHAR is a single ASCII character used to delimit the row values. 
(Default row delimiter is the newline (NL) character.) 


-trunicate 


specifies that if the file already exists, it should be truncated. 
(Default) 
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write data_file write data file 


Notes 


The -create_ columns control argument aids in the restructuring of tables. The 
column positions specified are the positions in the output file where the null value is 
placed. To create two new columns as the third and fifth columns in the output file, 
the string "-create_ columns 35" would be used. The null value is provided by placing 
two column delimiters together without any intervening characters, and the zero 
length character string is converted according to the data type of the column when the 
store from _data_file request processes the input file. 


Column values are examined to determine if they contain quotes, column 
delimiters, or rowdelimiters. If anyof these are found, the column value is requoted 


before it is placed in the output file. The store from _data_file request removes this 
layer of quotes when processing the file. 


Examples 
write data file employee data 
write data_file employee data -extend 
write data file employee data -create columns 1 5 
write data file employee data -column_ delimiter X 
write data_file employee data 
abel~ 1714555. 01736 ~m~ s~ak™~ juneau 
abel1~2~13000.01°55°~f"m az” phoenix 


baker~17~12000. 10~71~m~s~il~ springfield 
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SECTION 6 


OBSOLETE LINUS CONTROL ARGUMENTS/ REQUESTS 


This section contains descriptions of the pre-MR10.2 linus command and 
associated requests that are obsoleted with the installation of MR10.2. The 
requests (invoke and lila) have been replaced by new requests, but will remain 
fully supported for an indefinite period. 


The invoke request has been replaced by "exec_com" and the functions of 
lila are replaced by the requests: 


apply 

qedx 

input query (lila new) 
print query (lila print) 
save query (lila save) 
translate query (lila proc) 


All of the above (new) requests are described in Section 4. 
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linus linus 


Name: linus 


This command invokes linus to access an MRDS data base. It provides both- 
retrieval and update operations. Data to be selected is specified via lila 
requests. 


Usage 
linus {macro path} {-control_ args} 


where: 


1. macro path 

~ is an optional argument that specifies the pathname of an ASCII 
segment from which linus is to take its initial instructions. Such 
a set of instructions is referred to as a macro. If path does not 
have a suffix of linus, then one is assumed. However, the suffix 
linus must be the last component of the name of the segment. Tf 
macro path is provided, linus executes the requests contained in the 
specified segment and then waits for the user to type further requests. 
If the -request control argument is provided, linus executes the 
specified requests and then waits for the user to type further requests. 
If both macro path and -request are omitted, linus waits for the 
user to type a request. A discussion of linus macros is provided 
later in this section. The usage of this argument is incompatible 
with usage of the -request control argument below. (Default -- linus 
waits for instruction from user input.) 


2. control args 
can be chosen from the following: 


-abbrev, -ab 
enables abbreviation expansion and editing of request lines. 


-arguments macro args, -ag macro args 
where macro args are one or more character strings to be substituted 
for special strings in the macro segment. This control argument may 
be specified only if macro path is provided. 


Note: This control argument must be the last control argument given. 
The others may be given in any order. 


-iteration, -it 
recognizes parentheses in the request line to indicate request line 
iteration. 


-no_abbrev, -nab 
disables abbreviation expansion and editing of request lines. (Default) 


-no_iteration, -nit 
parentheses in the request line are interpreted literally (i.e., 
they do not cause request line iteration. (Default) 

-no_prompt, -npmt 
turns off prompting of strings. This control argument can be overridden 
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linus linus 


later (see set_mode request). (Default is prompt.) 


-no start up, -nsu 
specifies that the subsystem start _up exec_com is not to be executed. 


-profile path, -pf path 
specifies the pathname of the profile used for abbreviation expansion. 
A profile suffix must be the last component to path; however, the 
suffix need not be supplied in the command line. This control argument 
implies -abbrev. "4 


-request STR, -rq STR 
executes STR as a linus request line before entering the request 


loop. The usage of this control argument is incompatible with the 
usage of the macro path argument. (Refer to macro_path description 
above.) ~ 


-set_ lila prompt string STR, -slaps STR . ae 4 
sets the prompting string used by lila to STR. If STR contains 
embedded blanks, it must be enclosed in quotes. (Default lila prompt 
is wo>m,) 


-set linus prompt string STR, -slups STR, -prompt STR 
“sets the prompting string uSed by linus to STR. If STR contains 
embedded blanks, it must be enclosed in quotes. (Default linus prompt 
is. “Linus: .) 


-Start_up, -su _ 
specifies that the subsystem start up exec com "start up.lec" is 
executed prior to entering the request loop. The start up is searched 
for in the user home directory, project directory, -and then >site. 
(Default) 


Notes 


While most users interact with linus through a terminal, this facility is 
designed to accept input through the user input I/O switch and to transmit output 
through the user output I/O switch. These switches can be controlled, via the 
io call command, to interface with other devices/files in addition to the user's 
terminal. For convenience, tne linus description assumes that the user's 
input/output device is a terminal. 


By default, linus prompts the user whenever input is expected from the 
user input I/O switch (the string "linus:" is displayed if at linus request 
level, or the symbol "->" is displayed if within the lila editor). seni to the 
description of the set_mode request for information on how to turn off prompting. 


Multics program_ Givepeuse conditions are noueeniode and handled by linus. 
Thus, the user may interrupt any request and resume the linus session by invoking 
the Multics program interrupt command. After the program interrupt command, linus 
waits for the user to type further requests. 


There is no data base creation facility within linus. Those users who wish 
to create their own data base should refer to Section 3 for information on the 
ereation of an MRDS data base. 
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linus linus 


LINUS Requests 


invoke, i 
executes requests in a designated linus macro segment. 


lila 
invokes the lila editor which is used to build and process lila 
expressions to select data for manipulation by subsequent linus 
requests. 


All other linus requests are listed and described in Section 4. 


Request: invoke, i 


This request specifies that requests contained in the designated macro segment 
are to be executed. Arguments may optionally be passed to the macro. This 
feature provides the capability to invoke a pre-defined series of linus requests. 


Usage 
i path {macro args} 


where: 


1s path 
is the pathname of the ASCII segment containing the linus macro. If 
path does not have a suffix of linus, then one is assumed. However, 
the suffix linus must be the last component of the name of path 
segment. 


o« macro args 
are character strings to be substituted for special strings in the 
macro segment. 


Note 


Upon acceptance of the invoke request, the macro segment is read and executed, 
line-by-line. Argument substitution also takes place on a line-by-line basis, 
after the line is read and prior to its execution. After all lines in the macro 
segment are processed, linus waits for the user to type further requests on the 
terminal. The macro facility is described in detail later in this section. The 
invoke request is not compatible with request line iteration. 
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linus 


Exampl 


e 


linus 


Execute the requests contained in the segment get salary.linus, passing the 
argument "John Smith". ae 


1 


inus: 


i get salary "John Smith" 


Request: lila 


This request invokes the lila editor which is used to build and process 
lila expressions. This is a line editor which is very similar to a basic editor. 
A processed lila expression must be available when a print, assign values, write, 
report, create list, modify, delete, or define temp table request is specified. 
(Refer to Section 1 for a description of the selection language and the syntax 
and semantics of lila.) 


Usage 


lila {-controi args} 


where control args can be chosen from the following: 


-build {start} {increment} 


-new 


invokes lila build mode, an automatic numbering mode, in the current 
lila text file. The value of start determines the first line number 
of the inserted text. The value of increment, when added to the 
previous line number, yields the next automatic line number. A value 
for start must be given if an increment is to be given. Both start 
and increment must be positive integers ranging from 1 to 9999. 
Build mode is exited by entering a line consisting only of a period 
(.). The default increment is 10 and the default start is the current 
last line number plus the increment. 


specifies that text from previous invocations of the lila editor are 
to be deleted. By default, previous text is made available for 
further editing and processing. 


Lila Requests 


identifies the lila editor of linus and the linus version number. 


displays a list of available requests. 
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linus linus 


build {start} {increment} 
invokes build mode in the current lila text file. The value of 
start designates the first automatic line number. The value of increment 
designates the offset used to generate succeeding automatic line 
numbers. (See -build control argument above.) 


execute, e 
passes the rest of the request line Bo the Multics command processor. 


invoke path {macro args}, i path {macro args} 
executes requests contained in the linus macro segment designated by 
path after passing any specified macro args. This request functions 
in the same fashion as the linus invoke request. 


line number 
deletes the text line specified by line number. 


' line number text line 
adds or replaces the line of text in the proper sequence as specified 
by line number. The line number may have a value ranging from 0 to 
9999. ~ . 


list, ls 
displays all text lines in the current lila file. 


list requests, Ilr 
displays a brief summary of available lila requests. 


new 
deletes all text from the current lila text file. 

proc 
processes the lila expression source text contained in the current 
lila file to produce a processed lila expression suitable for use by 
subsequent linus data manipulation requests. 

quit, q 


terminates the current lila session, and places the user at linus 
request level. The contents of the current lila file are retained 
for possible manipulation in a subsequent lila session within the 
eurrent linus session. 


Save path, sv path 
writes the contents of the current lila file to the segment designated 
by path for use by a subsequent invoke. If not present, a suffix of 
linus is added to path. 


Example 


Build and process a lila expression to find all items sold by departments 
located on the second floor. In the following example, one line (30) is purposely 
input with a mistake which is subsequently corrected. 


linus: lila -new 

-~> 10 select item 

-> 20 from sales 

-> 30 where dept = {select deppt 

-> 40 from loc 

-> 50 where floor = 2} 
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linus linus 


-> ls” 

0010 select item 

0020 from sales 

0030 where dept = {select deppt 
OO4O0 from loc 

0050 where floor = 2} 


The next entry corrects a typo "deppt" shown in line 30. 


-> 30 where dept = {select dept 
-> ls 

0010 select item 

0020 from sales 

0036 where dept = {select dept 


0040 from loc 

0050 where floor = 2} 
-> proc 

-> q. 
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MACRO FACILITY 


Linus provides the capability to execute a series of requests contained in 
a text segment. Such a segment is referred to as qa linus macro segment. The 
name of a linus macro segment must have a suffix of linus. 


A linus macro may be invoked in one of two ways: 1) via the linus command 
line, or 2) via the linus or lila invoke requests, Invocation via the linus 
command line is: 


linus macro path -arguments arg1... argn 


which is equivalent to the sequence: 


linus 
invoke macro path argl ... argn 


A linus macro segment contains a series of linus requests in the same 
format as if they were entered at the terminal. Comments may appear in a linus 
macro segment as they would in a PL/I source segment, with the exception that a 
comment must be contained within one line. Arguments to the linus macro can be 
specified in a method analogous to the specification of arguments to a Multics 
exec com. In a linus macro, strings of the form $i% are interpreted as dummy 
arguments and are replaced by the corresponding macro args in the invoke request 
or in the linus command line. For example, macro arg1 is substituted for the 
string %1% and macro argi0 is substituted for the string 410%. Substitutions 
are also made within quoted strings. If a % is to be included in a string, %% 
must be specified. 


The following is an example of a linus macro that displays the sales volume, 
given a department name and item code: 


o dept store retrieval /* o data base */ 

ss sales rn /* allow read only, no prevents */ 
lila -new /* specify the data */ 

10 select vol 

20 from sales 

30 where dept = "41%" & item = %2% 

proc 

q : 
pr -no header /* no need for header */ 
ds * — /* clean up */ 

re 

q 


Assume this macro resides in the segment volume.linus. Then, in order to obtain 
the sales volume for item 20 in the shoe department, the user types: 


linus volume -arguments shoe 20 
and the resulting where clause reads: 


where dept = "shoe" & item = 20 
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SECTION 7 


EXEC COM FACILITY 


The capability to execute a series of requests contained in a text segment is 
provided by linus. Such a segment is referred to as a linus exec_com. The name ofa 
linus exec _com must have a suffix of lec. A linus exec_com is executed by the 
sequence: 


linus 
linus: ec exec_com_path farg1 ... argn} 


A linus macro segment contains a series of linus requests in the same format as 
they were entered at the terminal. It is possible to specify arguments to the linus 
exec com. In the linus exec_com, strings of the form &1 are substitutable arguments 
and are replaced by the corresponding exec com arguments in the exec com request line. 
For example, exec_com argument 1 is substituted for the string &1, and exec_com 
argument 10 is substituted for the string &10. 


An example of a linus exec_com that displays the sales volume, given a department 
name and item code, is: 


&version 2 


Pema ne vn tt 2 


&trace off &= no need to see requests as they execute 
&attach &- have linus read lines from here 
&if &fe equal &n 2] &- make sure two args were supplied 
&then &- yes they were 
&else &do &- no they weren't, print usage and return 
&print Usage: "ec volume dept item" 
&return 
&end ; 
&if &Lopen dept_store r] &- open data base 
&then &if &{set_ scope sales r nj] &- allow read only, no prevents 
&then &goto continue &- scope was set 
&else close &=- scope wasn't set 
&print The data base is not available. Try again later. 
é&return 
&label continue 
input_query -brief -force &- specify the data 


select vol 
from sales 
where dept = "&1" && item = &2 &- must specify 2 &&s to get 1 & 


sfo -tl off -pl 0 &- turn title line off and set page length to 0 
display &- display the data 

del_scope * &- delete all scope 

close &- close the data base 

&detach &- have linus read lines from terminal again 
&quit &- and return to linus 


Assume this exec_com resides in the segment volume.lec. Then, in order to obtain 
the sales volume for item 20 in the shoe department, the user enters: 
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linus 
linus: ec volume shoe 29 


and the resulting where clause reads: 


wnere dept = "shoe" & item = 20 
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APPENDIX 


STATIC DATA PARAMETERS 


The following parameters were used during the generation of the LINUS system 


software. 


Default buffer size - 256 words (linus_data_$buff_len). 


Default value for the maximum number of arguments a scalar function may take 
- 20 (linus data_$max_sclf_items). 


Maximum depth of invoke nesting - 20 (linus _data_$max_invocs). 

Maximum length of a linus request - 5000 characters (linus_data_$req_buf_len) 
Maximum number of arguments to linus - 100 (linus _data_$max_req_args). 
Maximum number of items in a from clause - 20 (linus_data_$max_range items). 
Maximum number of items in a select clause - 100 (linus _data_$max_user_items). 


Maximum number of LINUS variables (using the assign value request) - 20 
(linus _data_$max_lvars). 


. Maximum number of MRDS items not previously selected that may occur in an 


expression - 20 (linus _data_$max_expr_items). 


Maximum number of set operators that may be stacked - 10 
(linus data_$max_set_stack_size). 


Maximum number of temporary tabies - 20 (mrds_data_$max_temp_reis). 
Maximum string size - 500000 bits (linus data _$lit_string size). 


Number of spaces between columns for the print request - 2 
(linus _data_$print_col_spaces). 


Print buffer length - 5000 characters (linus_data_$pr_buff_len). 


The following parameters were used for the generation of linus_lila_ tokens _, 


which are used to define the keywords of a select statement. This segment is not bound 


Jn oud 


ith linus. 


hls w 
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select - linus_lila_tokens $select 


from ~ linus lila tokens _$from 
where - linus lila_ tokens $where 
inter - linus Tila tokens _$inter 
union - linus _ lila_ tokens  $union 
differ - linus lila tokens $differ 
unique - linus lila_tokens $unique 
dup - linus _lila_tokens $dup 
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INDEX 


em 


abbreviations (cont.) 
see exclamation mark s (store) 
sfo (set_format_options) 
n ss (set_Scope) 
see quotes svfo esave tore opeeons) 
. tq (translate query 
se | DST CHE at: oy RovatTonal take Steed) 
i : } Multies Relationa ata ore 
See. DOU tan megs MRPG (Multies Report Program 
‘ ee etic 
: Slaps (set lila prompt string 
See 008 slups (set_linuS_prompt_string) 


; os abs 
see semicolon 4-2, ade: inet iens 


‘ after 
see prompting mode see functions 


see prompting mode arithmetic expression 1-4 
assign entry 


abbreviations see functions 


dup (duplicate) 
LILA (LINUS LAnguage) 


LINUS (Logical Inquiry and Update asterisk 1~3 
System) 
linus command avg : 
requests see functions 
ab (abbrev) ; nue 
ap (apply) Backus-Naur Form 1-7 
av eee 
e (close before 
els (create list) see functions 
elv (column_value) 
d (delete) braces 1-4 


del (declare) 

di (display) 

dib (display builtins) 
ditt (delete_temp table) 
ds (dei scope) 


; cale entry 
te ad la see functions 


built-in functions 
see functions 


ec (exec com) 


fl (format line) ceil . 

h (help) ~ see functions 

i (invoke) 

iq (input query) character string constants 
ldb (list db) see constants 

lh (list_help) 

lr (list requests) clause 

ls (list scope) from 1-2 

lsfo (list format options) select 1-2, 1-3 

lv (list values) ~— asterisk 1-3 

m (modify) restriction 5-18, 5-20, 5-44 
o (open) where 1-2 

odb (opened database) if omitted 1-9 

p' (print) ~ logical operators 1-3 
pic (picture) parentheses 1-3 

pa (print query) relational operators 1-3 
q (quit) ~ where” 1-3 

q (see lila request) 

qx (gedx) eolumn 3-1 

rpt (report) names 


rsfo (restore _format_options) see names 
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column (cont.) 
values 
specify 5-44 


command processor 
invoking 5-21 


econecat 
see functions 


constants 
character string 1-3 
quotes 1-3 
count 


see functions 


data base 
access 5-2, 6-2 
add to 5-66 
example 5-67 
closing 5-14 
create lister file 5-1 
creation 3-1, 5-3, 6-3 
example 3-1 
delete rows 5-20 
display 5-48 
display open 5-35 
example 1-2, 3-1 
modify 5-44 
open 5-46 
update example 5-65 


data submodel 5-46 


designators 
row 1-6, 1-10 


differ (set operation) 
see operations 


display data 5-48 
domain 1-3, 1-9, 3-1 
dot 5-4, 5-8 


duplicate (dup) 
see selected values 


evaluation 
order of 1-10 


union, differ, and inter 1-9 


use of braces 1-9 


use of parentheses 1-10 


exclamation mark 5-12 


exec com 
facility 7-1 


file 
Multics 
generation 5-71 
output 5-71 
generation 5-71 


floor 
see functions 


formatted report 5-15, 5-51 


from clause 
see clause 


functions 
built-in 1-9, 2-1 
arithmetic scalar 


round 2-5 


search 2-6 
verify 2-7 
examples 


arithmetic set -- avg 1-4, 1-5, 


5-16, 5-18 


arithmetic set -- max 1-4 
string sealar -- substr 5-16 


string scalar 
after 2-1 
before 2-2 
coneat 2-3 
index 2-4 
reverse 2-5 
substr 2-6 
declared 5-17 


installation-defined 2-7 


nonstandard 2-7, 5-1 
restrictions 2-7 
scalar 2-7, 5-16, 5-17 
set 1-4, 2-7, 5 
assign entry 
cale entry 2- 
sets 5-16 


identifier 
dollar sign 1-10 
hyphen 1-10 


index 
see functions 


installation-defined functions 


see functions 


inter (set operation) 
see operations 


key column i-2, 5-18, 5- 
LILA 
also see abbreviations 
expression 
example 6-6 


lila requests 
summary of 6-5 


line editor 
lila 6-5 


LINUS 
also see abbreviations 
session 
terminate 5-51 
variables 
using set 5-12 


linus command 5-2, 6-2 
ease 


e 


? 5-8 


tw 


linus command (cont.) © max 


abbrev 5-8 see functions 
answer 5-9 

apply 5-11 metalanguage 
assign values 5-12 symbols 1-7 
elose 5-14 underscore of 1-7 
column value 5-14 

create eT aed min 

declare s funeti 
define _temp_ vars 5-17 aoe eee 
del seope 5-1 

deléte 5-20 neg 


delete temp table 5-21 cea ue 


display 5-2T 


mode 
hat BUTT ELOS o> <2 set or reset 5-63 
exec com 5-28 
execute 5-29 MRDS er 
format line 5-30. see abbreviations 
help 5-32 : 
if 5-33 MRPG Rae 
input query 5-34 see abbreviations 
invoke 6-4 
lila 6-5 names 
list db 5-35 column 1-3, 1-6 
list format options 5-37 table 1-6 
list_help 5-40 variable 5-12 
list requests a 44 exclamation mark 5-12 
list seope 5-42 
list values 5-42 nesting 1-6 
ltrim 5-43 
modify 5-44 nonstandard functions 
open 5-46 see functions 


opened database 5-47 


picture 5-48 null strings 5-45 


print 5-48 
Pedy Soso a=28 operations 
quit 5-51 set. 
report 5-51 differ 1-5 
restore format options 5-52 inter 1-5 
rtrim 5-53 union 1-5 
save format_options 5-53 union, FOG sug oer 1-9 
save query 5-55 union-compatible 1-9 
set format options 5-55 
set mode 5-63 operators | 
set scope 5-64 arithmetic 1-3 
store 5-66 evaluation precedence 1-19 
store from data_file 5-68 logical ade 
string 5-69 relational 1-3 
subsystem_name 5-69 
subsystem version 5-70 order of evaluation 
translate query 5-70 see evaluation 
write 5-7T 
write data file 5-72 output file 5-71 

set_lila_prompt_string 6- a 

set_linusS prompt _ ei. ar 2, 6-3 parameters 

summary of requests 5-4, 6-3 static data A-1 

lister command 5-15 parentheses 1-3 


formatted report 5-15 


: program interrupt 5-3, 6-3 
lister file 5-15 = = 


create 5-16 PrODpE roe mode 5-63 
‘ > 5-3, 5-63, 6-3 
logical operators also See set_lila_prompt_ string 


also see set_linus_prompt_string 


macro 6-2, 6-4 2 
pec ilaty 6-8 linus: 5-63 
invoke 6-8 
example 6~8 question mark 
segment 6-8 see prompting mode 
execute 6-4 
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quotes 1-3 


relational operators 
see operators 


report generation 5-51 


report writer 4-1 


default report elements 4-5 


format options 4-2 
active 4-3 


general column 4-2 
general report 4-2 


requests 4-4 


specifie column 4-3 


values 4-3 


full page formatting 4-10 
optional report elements 4-6 


user session 4-13 


requests 
see linus command 


reverse 
see functions 


round 
see functions 


row 1-2, 3-1 
designators 
see designators 


scalar functions 
see functions 


, 


scope of access 5-19, 5-42 


defining 5-64 


operation codes 5-65 


search 
see functions 


select clause 
see clause 


select-from-where block 1-2 


inner 
braces 1-4 
set functions 
see functions 


selected values 


duplicate 1-9 
unique 1-9 
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selection language 1-1 
examples 1-1 


semicolon 4-23 


set functions 
see functions 


set operations 
see operations 


set_lila_prompt_string 5-63, 6-2 
set_linus_prompt_string 5-63, 6-3 


substr 
see functions 


sum 
see functions 


symbols 
see metalanguage 


Syntax and Semantics of the Selection 
Language 1-7 


table 1-1, 1-6, 3-1 
names 
see names 
temporary table 5-17 
expression simplification 5-18 
restriction 5-18, 5-36 


Porm inotogs differences (LINUS/MRDS ) 
3 


text segment 6-8 


union (set operation) 
see operations 


unique 
see selected values 


user interaction 6-3 
variable 1-6 
list 5-12 
name 
see names 


verify 
see functions 


where clause 
see clause 
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